一、核心定义UNIX Socket（UNIX域套接字/UDS）：仅Linux/Unix本地的进程间通信（IPC）方式，以.sock特殊文件为通信标识，进程通过操作系统内核直接交换数据，完全不经过网络协议栈，是本地进程通信的高性能首选。与TCP/IP（127.0.0.1）核心对比（重点）对比维度TCP/IP（本地如127.0.0.1:3306）UNIX Socket（如/var/run/mysqld/mysqld.sock）通信范围本地/跨服务器（网络）仅同一Linux/Unix服务器通信标识IP+端口本地.sock文件（无实际数据，仅作通信入口）数据传输路径进程→网络协议栈→内核→网络协议栈→进程进程→内核→进程（仅内核拷贝，无网络开销）性能有封装/解包开销，延迟一般延迟极低、吞吐量高（本地首选）配置/安全需IP/端口，需开放防火墙仅需.sock路径，无端口/防火墙风险资源占用占用端口/网络连接资源仅占用磁盘文件，资源消耗可忽略通俗类比：TCP/IP是「同城快递（走网点流程）」，UNIX Socket是「邻居串门（直接沟通）」。二、核心原理（PHP开发只需掌握3点）.sock文件是通信标识，非普通文件，不存传输数据，删除会直接中断通信；数据全程在内核空间拷贝，跳过网卡、TCP握手、IP封装等网络环节（性能高的根本原因）；遵循C/S客户端-服务端模型，和TCP使用逻辑一致：服务端绑定.sock文件监听，客户端连接.sock文件通信，通信后文件保留（服务端停止则销毁）。三、PHP开发核心使用场景（生产环境标配）场景1：PHP连接本地MySQL/MariaDB（替代127.0.0.1:3306）步骤1：查询MySQL的.sock文件路径（3种方法）查配置文件：/etc/my.cnf//etc/mysql/my.cnf 中的socket配置项；MySQL命令行：mysql -uroot -p -e "show variables like 'socket';"；系统查找：find / -name "*.sock" | grep mysql。步骤2：PHP代码写法（PDO/Mysqli/框架对比）核心变化：去掉host/port，新增unix_socket指定.sock路径。// 1. PDO（TCP vs Socket） $pdo_tcp = new PDO('mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4', 'root', '123456'); $pdo_sock = new PDO('mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test;charset=utf8mb4', 'root', '123456'); // 2. Mysqli（TCP vs Socket） $mysqli_tcp = new mysqli('127.0.0.1', 'root', '123456', 'test', 3306); $mysqli_sock = new mysqli(null, 'root', '123456', 'test', 0, '/var/run/mysqld/mysqld.sock'); // 3. Laravel框架（.env配置，其他框架同理） # TCP配置 DB_HOST=127.0.0.1 DB_PORT=3306 # Socket配置（注释上面，新增下面） DB_UNIX_SOCKET=/var/run/mysqld/mysqld.sock场景2：Nginx通过UNIX Socket连接PHP-FPM（替代127.0.0.1:9000）步骤1：配置PHP-FPM的.sock（/etc/php-fpm.d/www.conf）; 注释TCP监听 ; listen = 127.0.0.1:9000 ; 开启Socket监听，指定路径 listen = /var/run/php-fpm/www.sock ; 关键：设置权限（Nginx和PHP-FPM统一用户，如www-data） listen.owner = www-data listen.group = www-data listen.mode = 0660步骤2：配置Nginx的Socket转发（站点配置）location ~ \.php$ { # 核心：替换为PHP-FPM的.sock路径 fastcgi_pass unix:/var/run/php-fpm/www.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }步骤3：重启生效systemctl restart php-fpm && systemctl restart nginx四、核心优势（PHP生产环境必用的原因）性能提升：本地通信延迟降低20%-50%，高并发下吞吐量优势更明显；配置简单：无需配置IP/端口，避免端口占用、防火墙开放等问题；更安全：不涉及网络传输，无端口扫描、远程恶意连接风险；开发零成本：仅需替换配置/参数，使用逻辑和TCP完全一致，无需额外学习；资源高效：不占用端口/网络资源，高并发下减少系统开销。五、避坑重点（3个高频问题，必记）1. 系统限制：仅支持Linux/Unix，Windows不支持开发环境（Windows/XAMPP/WAMP）：只能用TCP/IP（127.0.0.1）；生产环境（Linux服务器）：放心用UNIX Socket（所有服务均支持）；特殊：WSL2（基于Linux内核）支持，WSL1不支持。2. 权限问题：客户端必须有.sock文件的读/写权限（最常踩坑）现象：连接时报「权限不足/连接拒绝」（如Nginx连PHP-FPM、PHP连MySQL）。解决方法（推荐生产环境方案1）：统一用户/用户组：让客户端和服务端进程归属同一用户（如Nginx/PHP-FPM均为www-data，将PHP进程加入mysql用户组）：usermod -aG mysql www-data # 加组 systemctl restart php-fpm mysql # 重启服务临时修改.sock权限（服务端重启后失效）：chmod 660 /var/run/mysqld/mysqld.sock # 读写权限 chown mysql:www-data /var/run/mysqld/mysqld.sock # 所属用户/组3. 存储问题：.sock文件需放在本地高速目录，且磁盘不能满推荐路径：/var/run/（内存文件系统，读写快，不占磁盘空间，也是MySQL/PHP-FPM默认路径）；禁止：将.sock放在网络磁盘（如NFS），内核不支持跨网络的Socket通信；注意：.sock所在磁盘分区满了，会导致进程无法创建/写入文件，直接中断通信。六、拓展场景（PHP开发可了解）除MySQL/PHP-FPM外，本地常用服务均支持UNIX Socket，配置逻辑一致：Redis：配置unixsocket /var/run/redis/redis.sock，PHP用predis/phpredis连接时指定sock路径；Memcached：本地通信可配置Socket，替代127.0.0.1:11211；本地微服务：同一服务器内的微服务进程，用Socket替代TCP提升通信性能。七、核心总结（PHP开发必记5句话）UNIX Socket是Linux本地进程通信方式，核心优势是无网络开销、高性能；本地通信优先用Socket，跨服务器通信必须用TCP/IP；PHP使用只需替换参数：去掉host/port，指定.sock文件路径；生产环境核心配置：PHP连本地MySQL、Nginx连PHP-FPM，全量替换为UNIX Socket；避坑核心：Linux专属、权限正确、存/var/run/目录。八、生产环境实操清单（一键落地）检查所有本地服务（MySQL/PHP-FPM/Redis）的.sock路径并记录；修改PHP代码/框架配置，将本地TCP连接替换为Socket连接；配置Nginx+PHP-FPM的Socket通信，统一进程用户；给所有.sock文件配置正确权限，将相关进程加入对应用户组；重启所有服务，测试连接是否正常。
深入理解 Nginx + PHP-FPM 的协同运行原理，搞清楚这两个组件各自的作用、数据如何流转，以及核心的通信和进程管理逻辑，本篇文章从组件分工、核心运行流程、通信方式、进程管理四个核心维度，用通俗易懂的方式详解，兼顾原理和实际运行细节。一、先明确核心组件的分工（为什么需要Nginx+PHP-FPM）PHP 是解释型脚本语言，本身无法直接处理 HTTP 请求、监听端口，也不擅长做静态资源解析、高并发网络通信；而 Nginx 是高性能的 HTTP 服务器/反向代理，擅长处理静态请求、高并发连接、TCP/IP 网络通信，但完全不能解析PHP脚本。PHP-FPM 是 PHP 官方推出的FastCGI 进程管理器（FastCGI Process Manager），是 FastCGI 协议的PHP实现，核心作用是管理PHP解析进程、接收并处理来自Nginx的PHP脚本解析请求、返回解析结果。简单总结分工：Nginx：前端「门卫+快递员」，负责接收所有客户端HTTP请求，过滤静态请求（html/css/js/图片等）自己直接处理，动态PHP请求转发给PHP-FPM，最后把PHP-FPM的解析结果返回给客户端。PHP-FPM：后端「脚本解析工头」，管理一群PHP解析进程，接收Nginx的转发请求，分配给子进程解析PHP脚本，生成HTML等动态内容后回传给Nginx。PHP解析进程：PHP-FPM的「工人」，实际执行PHP代码、完成脚本解析的最小单元。补充：FastCGI 是一种通信协议（属于应用层协议），作用是让「Web服务器（Nginx）」和「脚本解析器（PHP）」这两个独立进程能标准化通信，替代了早期效率极低的CGI协议（每次请求都创建新进程，高并发下性能暴跌）。二、Nginx+PHP-FPM 核心运行流程（一次PHP请求的完整流转）以用户访问 http://域名/index.php?name=test 为例，从客户端发起请求到最终收到响应的完整步骤，每一步都标注核心动作，流程清晰无冗余：客户端（浏览器/Postman） → 网络层（TCP/IP） → Nginx → FastCGI协议 → PHP-FPM → PHP解析进程 → 回传结果 → Nginx → 客户端逐步骤拆解（关键步骤标粗）：客户端发起HTTP请求：用户输入URL后，客户端与Nginx建立TCP连接（默认80/443端口），发送HTTP请求（包含请求方法、URL、请求头、参数等）。Nginx接收并解析请求：Nginx监听80/443端口，接收到请求后，通过nginx.conf配置的location规则匹配请求路径：如果是静态资源（如/css/index.css），Nginx直接从本地磁盘读取文件，通过TCP连接返回给客户端，全程不涉及PHP-FPM；如果是PHP动态请求（如/index.php），Nginx触发FastCGI转发规则，准备将请求信息封装成FastCGI协议格式。Nginx封装请求并转发给PHP-FPM：Nginx根据配置的PHP-FPM地址（IP+端口/UNIX套接字），将HTTP请求的核心信息（脚本路径、请求参数、请求头、环境变量如REQUEST_METHOD/REQUEST_URI）按照FastCGI协议规范封装，发送给PHP-FPM。PHP-FPM接收请求并分配进程：PHP-FPM监听自己的端口（默认9000）或UNIX套接字，接收到FastCGI请求后，由主进程（master process） 分配给空闲的PHP子进程（worker process）（如果没有空闲子进程，会根据进程管理规则创建新进程或让请求排队）。PHP子进程解析执行脚本：空闲的PHP子进程接收请求后，执行以下操作：读取指定路径的PHP脚本文件（如/var/www/html/index.php）；解释执行PHP代码，处理业务逻辑（如连接数据库、处理参数、生成动态HTML）；执行完成后，将执行结果（动态HTML内容、响应状态码、响应头）按照FastCGI协议封装。PHP-FPM回传结果给Nginx：PHP子进程将封装好的解析结果返回给PHP-FPM主进程，再由主进程回传给Nginx。Nginx接收结果并返回给客户端：Nginx接收到PHP-FPM的回传数据后，将FastCGI格式的结果转换回HTTP协议格式（补充HTTP响应头、状态码），通过最初建立的TCP连接，将最终的响应内容（动态HTML）发送给客户端。释放连接/资源：客户端接收响应后，关闭TCP连接（或根据HTTP/1.1的Keep-Alive保持连接）；Nginx和PHP-FPM的相关进程回到空闲状态，等待下一次请求。核心关键点：整个流程中，Nginx只做「转发和返回」，不碰PHP代码；PHP-FPM只做「接收和分配」，不碰HTTP协议；真正执行PHP代码的是PHP子进程，三者解耦，各司其职，这也是该架构高性能的核心原因。三、Nginx与PHP-FPM的两种核心通信方式Nginx和PHP-FPM之间的通信是整个架构的关键环节，配置在Nginx的fastcgi_pass指令中，主要有两种方式，各有优劣，适用于不同场景，也是实际部署中最常配置的部分：方式1：UNIX域套接字（UNIX Socket）配置格式：fastcgi_pass unix:/var/run/php-fpm/www.sock;（sock文件路径由PHP-FPM配置）通信原理：基于本地文件的进程间通信（IPC），不经过网络协议栈（无需IP/端口），直接通过内核交换数据，延迟更低、性能更高。适用场景：Nginx和PHP-FPM部署在同一台服务器（绝大多数生产场景）。注意事项：需要保证sock文件的权限正确（Nginx进程用户如www-data需要有读/写权限），否则会出现「连接拒绝」错误；sock文件存储在磁盘临时目录，需避免磁盘IO瓶颈。方式2：TCP/IP套接字（网络端口）配置格式：fastcgi_pass 127.0.0.1:9000;（如果PHP-FPM在另一台服务器，填远程IP如192.168.1.100:9000）通信原理：基于TCP/IP协议的网络通信，即使是本地127.0.0.1，也会经过内核的网络协议栈封装/解包，延迟略高，但兼容性更好。适用场景：Nginx和PHP-FPM部署在不同服务器（分布式部署场景），或需要跨服务器转发PHP请求。注意事项：PHP-FPM需要配置监听远程IP（默认只监听127.0.0.1，需改为0.0.0.0:9000），并开放服务器9000端口（防火墙/安全组）；存在网络传输的安全风险，建议搭配内网访问或加密。性能对比：同一服务器下，UNIX Socket > TCP/IP（127.0.0.1），生产环境优先用UNIX Socket。四、PHP-FPM的核心：进程管理机制（高性能的关键）PHP-FPM的性能核心在于进程管理，由主进程（master）统一管理子进程（worker），避免了CGI「每次请求创建进程」的低效问题，支持三种进程管理模式，配置在PHP-FPM的配置文件（如/etc/php-fpm.d/www.conf）的pm指令中，不同模式适配不同的并发量场景。先明确两个基础配置（所有模式都需要设置）：pm.max_children：PHP-FPM允许创建的最大子进程数（核心配置，决定最大并发处理能力，需根据服务器CPU/内存配置，如4核8G服务器一般设20-40）；pm.start_servers：PHP-FPM启动时默认创建的空闲子进程数（无需等待请求再创建，提升首次请求响应速度）。模式1：静态模式（pm = static）核心逻辑：PHP-FPM启动后，直接创建pm.max_children个固定数量的子进程，运行期间子进程数不增不减，主进程只负责将请求分配给空闲子进程。优点：进程数固定，无进程创建/销毁的开销，性能最稳定，适合高并发、请求量稳定的场景（如电商、直播平台）。缺点：即使没有请求，所有子进程也会占用内存，内存利用率较低（如果服务器空闲，大量子进程占内存但无工作）。关键配置：仅需设置pm.max_children和pm.start_servers（start_servers ≤ max_children）。模式2：动态模式（pm = dynamic）核心逻辑：子进程数根据请求量动态调整，介于pm.min_spare_servers（最小空闲子进程数）和pm.max_children之间，主进程会根据空闲子进程数自动创建/销毁子进程：当空闲子进程数 < 最小空闲数：创建新的子进程；当空闲子进程数 > 最大空闲数（pm.max_spare_servers）：销毁多余的空闲子进程。优点：内存利用率高，空闲时销毁多余进程，节省内存，适合请求量波动大的场景（如企业官网、小型应用）。缺点：请求量突增时，主进程需要创建新进程，存在短暂的进程创建开销，极端情况下可能影响响应速度。关键配置：pm.min_spare_servers（最小空闲）、pm.max_spare_servers（最大空闲）、pm.max_children（最大进程）。模式3：按需模式（pm = ondemand）核心逻辑：最极致的动态模式，PHP-FPM启动后不创建任何子进程，只有当有请求进来时，主进程才会创建子进程处理请求；请求处理完成后，子进程会在指定时间（pm.process_idle_timeout）内空闲，超时后自动销毁。优点：内存利用率极致高，空闲时几乎不占内存，适合请求量极低、偶尔有访问的场景（如个人博客、测试环境）。缺点：首次请求响应慢（需要创建子进程），请求量突增时进程创建开销大，不适合高并发场景。关键配置：pm.max_children（最大进程）、pm.process_idle_timeout（子进程空闲超时时间，默认10s）。进程管理核心原则：pm.max_children的设置是关键，不能过大也不能过小：过小：请求数超过最大进程数，后续请求会排队，导致页面加载慢、超时；过大：每个PHP子进程占用约20-50M内存，过多进程会导致服务器内存耗尽，触发OOM（内存溢出），进程被内核杀死，服务崩溃。五、补充：Nginx的FastCGI核心配置（必配项）Nginx转发PHP请求时，需要在nginx.conf或站点配置中添加FastCGI核心配置，否则PHP-FPM无法正确解析请求，核心配置如下（实际部署可直接复用）：server { listen 80; server_name 你的域名; root /var/www/html; # PHP项目根目录 index index.php index.html; # 匹配PHP请求，转发给PHP-FPM location ~ \.php$ { fastcgi_pass unix:/var/run/php-fpm/www.sock; # 通信方式（UNIX Socket），替换为127.0.0.1:9000则为TCP fastcgi_index index.php; # 核心：传递PHP脚本真实路径给PHP-FPM（必须配，否则PHP-FPM找不到脚本） fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # 加载FastCGI默认配置（包含请求头、环境变量等） include fastcgi_params; } # 禁止直接访问PHP源码目录 location ~ /\.ht { deny all; } }核心必配项：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，作用是将Nginx解析到的PHP脚本绝对路径传递给PHP-FPM，否则PHP-FPM会因找不到脚本返回404或502错误。六、常见异常：502 Bad Gateway（最常遇到）Nginx+PHP-FPM架构中，502错误是最常见的异常，本质是Nginx无法连接到PHP-FPM，核心原因主要有4种，排查顺序从易到难：PHP-FPM服务未启动/已崩溃：执行systemctl status php-fpm查看状态，重启systemctl restart php-fpm；通信方式配置错误：Nginx的fastcgi_pass与PHP-FPM的监听地址（listen指令）不匹配，或端口/套接字被占用；PHP-FPM进程数耗尽：pm.max_children设置过小，请求量超过最大进程数，需调大该值并重启PHP-FPM；权限问题：UNIX Socket文件的权限不足，Nginx进程用户无法读写，执行chmod 660 /var/run/php-fpm/www.sock并chown www-data:www-data /var/run/php-fpm/www.sock（匹配Nginx和PHP-FPM的运行用户）。总结（核心关键点回顾）分工解耦：Nginx处理HTTP和静态资源，PHP-FPM管理PHP进程，PHP子进程执行脚本，三者通过FastCGI协议通信，是高性能的核心；运行流程：客户端→Nginx（解析/转发）→PHP-FPM（分配进程）→PHP子进程（执行脚本）→回传Nginx→客户端，全程两次协议转换（HTTP→FastCGI→HTTP）；通信方式：同一服务器优先用UNIX Socket（高性能），跨服务器用TCP/IP（兼容性）；进程管理：PHP-FPM主进程管理子进程，支持静态（高并发稳定）、动态（内存高效）、按需（极低请求）三种模式，pm.max_children是核心配置；核心配置：Nginx必须配SCRIPT_FILENAME传递脚本绝对路径，否则会出现502/404错误。整个架构的设计思路是「专业的事交给专业的组件」，Nginx发挥高并发网络通信的优势，PHP-FPM解决PHP脚本的进程管理和解析效率问题，两者结合成为目前PHP Web开发的工业级标准架构，支撑绝大多数PHP生产项目（如WordPress、Laravel、ThinkPHP项目）。
官方文档：https://carbon.nesbot.com/docs/安装方法1. 基本安装# 在项目根目录执行 composer require nesbot/carbon2. 指定版本安装# 安装特定版本 composer require nesbot/carbon:^2.0 # 安装开发版本 composer require nesbot/carbon --dev基本使用方法1. 引入 Carbonuse Carbon\Carbon; // 获取当前时间 $now = Carbon::now(); echo $now; // 2023-10-27 14:30:00 // 创建指定时间 $date = Carbon::create(2023, 12, 25, 10, 30, 0);2. 常用方法示例use Carbon\Carbon; // 格式化输出 echo Carbon::now()->format('Y-m-d H:i:s'); echo Carbon::now()->toDateString(); // 2023-10-27 echo Carbon::now()->toDateTimeString(); // 2023-10-27 14:30:00 // 日期操作 $tomorrow = Carbon::now()->addDay(); $yesterday = Carbon::now()->subDay(); $nextWeek = Carbon::now()->addWeek(); // 日期比较 $date1 = Carbon::create(2023, 10, 27); $date2 = Carbon::create(2023, 10, 28); if ($date1->lt($date2)) { // less than echo "date1 在 date2 之前"; } // 时区设置 $date = Carbon::now('Asia/Shanghai'); $date->setTimezone('America/New_York');3. 本地化（中文支持）# 安装语言包 composer require carbonphp/carbon-doctrine-typesuse Carbon\Carbon; // 设置中文 Carbon::setLocale('zh'); echo Carbon::now()->diffForHumans(); // 刚刚 echo Carbon::now()->subMinutes(5)->diffForHumans(); // 5分钟前配置文件（可选）在 Laravel 项目中，可以在 config/app.php 中配置时区：'timezone' => 'Asia/Shanghai', 'locale' => 'zh-CN',验证安装创建测试文件验证安装：<?php require 'vendor/autoload.php'; use Carbon\Carbon; echo "当前时间：" . Carbon::now() . "\n"; echo "明天：" . Carbon::now()->addDay() . "\n"; echo "一周前：" . Carbon::now()->subWeek()->diffForHumans() . "\n";常见问题解决版本兼容性问题# 查看当前PHP版本支持的Carbon版本 php -v # 如果PHP版本较旧，使用Carbon 1.x composer require nesbot/carbon:^1.39内存问题# 清理composer缓存 composer clear-cache代理设置# 如果下载慢，使用国内镜像 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/在框架中的使用LaravelCarbon 已集成在 Laravel 中，可直接使用：// 在Laravel中直接使用 $date = now(); // Carbon实例 echo $date->format('Y-m-d');其他框架// Slim, Symfony等框架 require __DIR__ . '/vendor/autoload.php'; use Carbon\Carbon; $carbon = new Carbon();这样就成功安装并可以使用 Carbon 来处理日期时间了。
PHP8.0 + 版本按数据处理类型分类的新增函数整理表格，包含函数名、对应版本、功能说明及可直接运行的用法示例
分类函数名PHP版本功能说明用法示例字符串处理str_contains()8.0检查字符串是否包含指定子串（区分大小写），返回布尔值$str = "Hello PHP8"; var_dump(str_contains($str, "PHP8")); // bool(true)var_dump(str_contains($str, "php8")); // bool(false)字符串处理str_starts_with()8.0检查字符串是否以指定子串开头（区分大小写），返回布尔值$str = "2025-12-11"; var_dump(str_starts_with($str, "2025")); // bool(true)var_dump(str_starts_with($str, "2024")); // bool(false)字符串处理str_ends_with()8.0检查字符串是否以指定子串结尾（区分大小写），返回布尔值$str = "test.txt"; var_dump(str_ends_with($str, ".txt")); // bool(true)var_dump(str_ends_with($str, ".php")); // bool(false)字符串处理mb_str_split()8.0多字节安全的字符串分割，支持指定分割长度（解决str_split多字节乱码）$str = "你好PHP8"; print_r(mb_str_split($str)); // [0]=>你 [1]=>好 [2]=>P [3]=>H [4]=>P [5]=>8print_r(mb_str_split($str, 2)); // [0]=>你好 [1]=>PH [2]=>P8字符串处理strlcpy()8.1安全的字符串拷贝（限制长度，含终止符），返回源字符串总长度$dest = ''; $src = "Hello World";$len = strlcpy($dest, $src, 6); echo $dest; // Helloecho $len; // 11字符串处理mb_str_pad()8.3多字节安全的字符串填充（解决str_pad多字节长度计算错误）$str = "你好"; echo mb_str_pad($str, 5, "-", STR_PAD_RIGHT); // 你好---数组处理array_is_list()8.1检查数组是否为“列表”（索引从0开始、连续递增的整数索引），返回布尔值$list = [1,2,3]; $notList = [0=>1,2=>3];var_dump(array_is_list($list)); // bool(true) var_dump(array_is_list($notList)); // bool(false)数组处理array_find()8.3返回数组中第一个满足回调条件的元素，无则返回null$nums = [1,2,3,4,5]; $even = array_find($nums, fn($n) => $n % 2 === 0); echo $even; // 2数组处理array_find_key()8.3返回数组中第一个满足回调条件的键，无则返回null$users = ['a'=>18, 'b'=>22, 'c'=>19]; $key = array_find_key($users, fn($age) => $age > 20); echo $key; // b数组处理array_any()8.3检查数组是否存在至少一个满足回调条件的元素，返回布尔值$nums = [1,3,5]; var_dump(array_any($nums, fn($n) => $n%2===0)); // bool(false)$nums[]=8; var_dump(array_any($nums, fn($n) => $n%2===0)); // bool(true)数组处理array_all()8.3检查数组所有元素是否都满足回调条件，返回布尔值$nums = [2,4,6]; var_dump(array_all($nums, fn($n) => $n%2===0)); // bool(true)$nums[]=9; var_dump(array_all($nums, fn($n) => $n%2===0)); // bool(false)数值处理fdiv()8.0浮点数除法（优雅处理除0场景，返回INF/-INF/NaN，替代普通除法）var_dump(fdiv(10,2)); // float(5)var_dump(fdiv(10,0)); // float(INF)var_dump(fdiv(0,0)); // float(NAN)数值处理enum_exists()8.1检查枚举类型是否已定义（适配8.1新增的枚举特性）enum Status { case Success; case Error; }var_dump(enum_exists('Status')); // bool(true)var_dump(enum_exists('NonExist')); // bool(false)日期时间处理DateTimeInterface::format_iso8601()8.2标准化输出ISO 8601格式日期，支持指定毫秒精度$dt = new DateTime('2025-12-11 10:00:00', new DateTimeZone('Asia/Shanghai')); echo $dt->format_iso8601(); // 2025-12-11T10:00:00+08:00echo $dt->format_iso8601(3); // 2025-12-11T10:00:00.000+08:00对象/类型处理get_debug_type()8.0更精准的变量类型获取（比gettype友好，支持枚举/对象等）$obj = new stdClass(); enum E { case A; } echo get_debug_type("test"); // string echo get_debug_type($obj); // stdClassecho get_debug_type(E::A); // E对象/类型处理ReflectionClass::isReadOnly()8.2反射检查类是否为只读类（适配8.2新增的readonly类特性）readonly class User { public string $name; } $ref = new ReflectionClass(User::class);var_dump($ref->isReadOnly()); // bool(true)JSON处理json_validate()8.3高效验证JSON字符串有效性（无需解码，性能优于json_decode）$valid = '{"name":"PHP8"}'; $invalid = '{"name":"PHP8"';var_dump(json_validate($valid)); // bool(true) var_dump(json_validate($invalid)); // bool(false)正则表达式preg_last_error_msg()8.0返回正则操作的可读错误信息（替代preg_last_error的数值码）preg_match('/[a-z/', 'test'); // 语法错误echo preg_last_error_msg(); // "missing terminating ] for character class"字节处理bytes_format()8.3将字节数格式化为易读单位（B/KB/MB/GB等），支持指定小数位数echo bytes_format(1024); // 1.00 KBecho bytes_format(1048576); // 1.00 MBecho bytes_format(1500, 0); // 2 KB关键说明：版本兼容性：表格中函数均为PHP8.0及以上新增/增强，部分函数（如array_find）仅在PHP8.3+可用，使用前需确认运行环境版本；多字节支持：mb_*开头的函数解决了中文等多字节字符的处理问题，推荐优先使用；性能优化：如json_validate比json_decode验证JSON更高效（无需解析整个字符串）；类型安全：get_debug_type、array_is_list等函数提升了PHP的类型判断精准度，适配8.0+的类型强化特性。
在宝塔环境中实现 Elasticsearch 与数据库的实时同步，主要有以下几种方案：一、同步方案概览方案实时性复杂度数据一致性适用场景应用层双写最高中等最终一致新建项目，可修改代码Logstash JDBC分钟级低延迟一致已有项目，增量同步Canal秒级高最终一致MySQL 数据库，要求高实时性数据库触发器实时高强一致数据库层面同步二、方案一：应用层双写（推荐）实现原理在业务代码中同时写入数据库和 Elasticsearch。PHP 实现示例<?php /** * 应用层双写方案 * 在写入数据库的同时写入 Elasticsearch */ require '/www/wwwroot/your-site/vendor/autoload.php'; use Elasticsearch\ClientBuilder; class DualWriteService { private $esClient; private $db; public function __construct() { // 初始化 ES 客户端 $this->esClient = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); // 初始化数据库连接 $this->initDatabase(); } private function initDatabase() { $host = 'localhost'; $dbname = 'your_database'; $username = 'your_username'; $password = 'your_password'; try { $this->db = new PDO( "mysql:host={$host};dbname={$dbname};charset=utf8mb4", $username, $password, [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC ] ); } catch (PDOException $e) { throw new Exception("数据库连接失败: " . $e->getMessage()); } } /** * 添加文章（双写） */ public function addArticle($articleData) { $dbResult = $this->writeToDatabase($articleData); if ($dbResult['success']) { $esResult = $this->writeToElasticsearch($articleData, $dbResult['id']); if (!$esResult['success']) { // ES 写入失败，记录日志或加入重试队列 $this->logSyncFailure('add', $dbResult['id'], $articleData); } return $dbResult; } return $dbResult; } /** * 更新文章（双写） */ public function updateArticle($id, $updateData) { $dbResult = $this->updateDatabase($id, $updateData); if ($dbResult['success']) { $esResult = $this->updateElasticsearch($id, $updateData); if (!$esResult['success']) { $this->logSyncFailure('update', $id, $updateData); } } return $dbResult; } /** * 删除文章（双写） */ public function deleteArticle($id) { $dbResult = $this->deleteFromDatabase($id); if ($dbResult['success']) { $esResult = $this->deleteFromElasticsearch($id); if (!$esResult['success']) { $this->logSyncFailure('delete', $id); } } return $dbResult; } /** * 写入数据库 */ private function writeToDatabase($data) { try { $sql = "INSERT INTO articles (title, content, author, category, tags, status, created_at, updated_at) VALUES (:title, :content, :author, :category, :tags, :status, NOW(), NOW())"; $stmt = $this->db->prepare($sql); $stmt->execute([ ':title' => $data['title'], ':content' => $data['content'], ':author' => $data['author'], ':category' => $data['category'], ':tags' => is_array($data['tags']) ? implode(',', $data['tags']) : $data['tags'], ':status' => $data['status'] ?? 1 ]); $id = $this->db->lastInsertId(); return [ 'success' => true, 'id' => $id ]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 写入 Elasticsearch */ private function writeToElasticsearch($data, $id) { try { $esData = [ 'id' => (int)$id, 'title' => $data['title'], 'content' => $data['content'], 'author' => $data['author'], 'category' => $data['category'], 'tags' => is_array($data['tags']) ? $data['tags'] : explode(',', $data['tags']), 'status' => $data['status'] ?? 1, 'created_at' => date('Y-m-d H:i:s'), 'updated_at' => date('Y-m-d H:i:s') ]; $params = [ 'index' => 'articles', 'id' => $id, 'body' => $esData ]; $response = $this->esClient->index($params); return ['success' => true]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 更新数据库 */ private function updateDatabase($id, $data) { try { $sql = "UPDATE articles SET title = :title, content = :content, author = :author, category = :category, tags = :tags, status = :status, updated_at = NOW() WHERE id = :id"; $stmt = $this->db->prepare($sql); $stmt->execute([ ':title' => $data['title'], ':content' => $data['content'], ':author' => $data['author'], ':category' => $data['category'], ':tags' => is_array($data['tags']) ? implode(',', $data['tags']) : $data['tags'], ':status' => $data['status'] ?? 1, ':id' => $id ]); return ['success' => true]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 更新 Elasticsearch */ private function updateElasticsearch($id, $data) { try { $updateData = [ 'title' => $data['title'], 'content' => $data['content'], 'author' => $data['author'], 'category' => $data['category'], 'tags' => is_array($data['tags']) ? $data['tags'] : explode(',', $data['tags']), 'status' => $data['status'] ?? 1, 'updated_at' => date('Y-m-d H:i:s') ]; $params = [ 'index' => 'articles', 'id' => $id, 'body' => [ 'doc' => $updateData ] ]; $response = $this->esClient->update($params); return ['success' => true]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 从数据库删除 */ private function deleteFromDatabase($id) { try { $sql = "DELETE FROM articles WHERE id = :id"; $stmt = $this->db->prepare($sql); $stmt->execute([':id' => $id]); return ['success' => true]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 从 Elasticsearch 删除 */ private function deleteFromElasticsearch($id) { try { $params = [ 'index' => 'articles', 'id' => $id ]; $response = $this->esClient->delete($params); return ['success' => true]; } catch (Exception $e) { return [ 'success' => false, 'error' => $e->getMessage() ]; } } /** * 记录同步失败 */ private function logSyncFailure($operation, $id, $data = null) { $logData = [ 'timestamp' => date('Y-m-d H:i:s'), 'operation' => $operation, 'id' => $id, 'data' => $data ]; file_put_contents( '/www/wwwlogs/es_sync_failures.log', json_encode($logData) . "\n", FILE_APPEND ); } /** * 重试失败的同步 */ public function retryFailedSyncs() { $logFile = '/www/wwwlogs/es_sync_failures.log'; if (!file_exists($logFile)) { return ['success' => true, 'message' => '无失败记录']; } $logs = file($logFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); $successCount = 0; $failCount = 0; foreach ($logs as $log) { $data = json_decode($log, true); try { switch ($data['operation']) { case 'add': $this->writeToElasticsearch($data['data'], $data['id']); break; case 'update': $this->updateElasticsearch($data['id'], $data['data']); break; case 'delete': $this->deleteFromElasticsearch($data['id']); break; } $successCount++; } catch (Exception $e) { $failCount++; } } // 清空日志文件 file_put_contents($logFile, ''); return [ 'success' => true, 'retried' => $successCount, 'failed' => $failCount ]; } } // 使用示例 $syncService = new DualWriteService(); // 添加文章 $article = [ 'title' => '测试文章标题', 'content' => '这是文章内容...', 'author' => '张三', 'category' => '技术', 'tags' => ['PHP', 'Elasticsearch', '搜索'], 'status' => 1 ]; $result = $syncService->addArticle($article); if ($result['success']) { echo "文章添加成功，ID: " . $result['id']; } else { echo "添加失败: " . $result['error']; } ?>三、方案二：Logstash JDBC 输入插件安装和配置 Logstash1. 在宝塔中安装 Logstash# 进入宝塔终端 cd /www/server # 下载 Logstash（版本需要与 ES 对应） wget https://artifacts.elastic.co/downloads/logstash/logstash-7.17.0-linux-x86_64.tar.gz # 解压 tar -zxvf logstash-7.17.0-linux-x86_64.tar.gz mv logstash-7.17.0 logstash # 下载 MySQL JDBC 驱动 cd logstash wget https://cdn.mysql.com/archives/mysql-connector-java-8.0/mysql-connector-java-8.0.28.tar.gz tar -zxvf mysql-connector-java-8.0.28.tar.gz2. 创建 Logstash 配置文件创建 /www/server/logstash/config/mysql-sync.conf：input { jdbc { # MySQL 连接配置 jdbc_connection_string => "jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&useSSL=false" jdbc_user => "your_username" jdbc_password => "your_password" # JDBC 驱动路径 jdbc_driver_library => "/www/server/logstash/mysql-connector-java-8.0.28/mysql-connector-java-8.0.28.jar" jdbc_driver_class => "com.mysql.cj.jdbc.Driver" # 启用分页 jdbc_paging_enabled => true jdbc_page_size => 50000 # 调度配置（每分钟执行一次） schedule => "* * * * *" # SQL 查询（增量同步） statement => "SELECT * FROM articles WHERE updated_at > :sql_last_value OR created_at > :sql_last_value" # 记录最后一次同步时间 use_column_value => true tracking_column_type => "timestamp" tracking_column => "updated_at" # 记录文件位置 last_run_metadata_path => "/www/server/logstash/last_run_metadata.txt" # 时区设置 jdbc_default_timezone => "Asia/Shanghai" } } filter { # 添加 @timestamp 字段 date { match => [ "updated_at", "yyyy-MM-dd HH:mm:ss" ] target => "@timestamp" } # 处理 tags 字段 if [tags] { mutate { gsub => [ "tags", ",", "|" ] split => { "tags" => "|" } } } # 移除不需要的字段 mutate { remove_field => ["@version", "@timestamp"] } } output { # 输出到 Elasticsearch elasticsearch { hosts => ["localhost:9200"] index => "articles" document_id => "%{id}" # 定义映射模板 template => "/www/server/logstash/config/articles-template.json" template_name => "articles" template_overwrite => true } # 可选：输出到文件用于调试 file { path => "/www/server/logstash/logs/mysql-sync.log" } }3. 创建 Elasticsearch 映射模板创建 /www/server/logstash/config/articles-template.json：{ "index_patterns": ["articles*"], "settings": { "number_of_shards": 1, "number_of_replicas": 0, "analysis": { "analyzer": { "ik_smart_analyzer": { "type": "custom", "tokenizer": "ik_smart" }, "ik_max_analyzer": { "type": "custom", "tokenizer": "ik_max_word" } } } }, "mappings": { "properties": { "id": {"type": "integer"}, "title": { "type": "text", "analyzer": "ik_smart_analyzer", "search_analyzer": "ik_smart_analyzer" }, "content": { "type": "text", "analyzer": "ik_max_analyzer", "search_analyzer": "ik_smart_analyzer" }, "author": {"type": "keyword"}, "category": {"type": "keyword"}, "tags": {"type": "keyword"}, "status": {"type": "integer"}, "created_at": {"type": "date", "format": "yyyy-MM-dd HH:mm:ss"}, "updated_at": {"type": "date", "format": "yyyy-MM-dd HH:mm:ss"} } } }4. 启动 Logstash# 创建日志目录 mkdir -p /www/server/logstash/logs # 启动 Logstash cd /www/server/logstash ./bin/logstash -f config/mysql-sync.conf # 或作为守护进程运行 nohup ./bin/logstash -f config/mysql-sync.conf > logs/logstash.log 2>&1 &5. 创建宝塔计划任务在宝塔面板中添加计划任务：# 命令 cd /www/server/logstash && ./bin/logstash -f config/mysql-sync.conf # 执行周期：每分钟四、方案三：Canal（MySQL Binlog 同步）安装和配置 Canal1. 安装 Canal# 下载 Canal cd /www/server wget https://github.com/alibaba/canal/releases/download/canal-1.1.6/canal.deployer-1.1.6.tar.gz tar -zxvf canal.deployer-1.1.6.tar.gz mv canal.deployer-1.1.6 canal2. 配置 MySQL 开启 Binlog-- 检查是否开启 binlog SHOW VARIABLES LIKE 'log_bin'; -- 如果没有开启，在 MySQL 配置文件中添加 -- /etc/my.cnf [mysqld] log-bin=mysql-bin binlog-format=ROW server_id=13. 创建 Canal 用户CREATE USER 'canal'@'%' IDENTIFIED BY 'canal_password'; GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%'; FLUSH PRIVILEGES;4. 配置 Canal编辑 /www/server/canal/conf/example/instance.properties：# 数据库配置 canal.instance.master.address=127.0.0.1:3306 canal.instance.dbUsername=canal canal.instance.dbPassword=canal_password canal.instance.connectionCharset=UTF-8 # 要监听的数据库和表 canal.instance.filter.regex=.*\\..* canal.instance.filter.black.regex= # 表映射 canal.instance.filter.regex=your_database.articles5. 创建 PHP Canal 客户端<?php /** * Canal PHP 客户端 * 监听 MySQL Binlog 并同步到 Elasticsearch */ class CanalClient { private $esClient; public function __construct() { $this->esClient = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); } public function startSync() { // 连接 Canal 服务器 $client = new \Canal\Client(); $client->connect("127.0.0.1", 11111); $client->subscribe("example", "your_database.articles", ""); while (true) { $message = $client->get(100); if ($message->getEntries()) { foreach ($message->getEntries() as $entry) { if ($entry->getEntryType() == \Canal\Protocol\EntryType::ROWDATA) { $this->processRowChange($entry); } } } sleep(1); // 避免 CPU 过高 } } private function processRowChange($entry) { $rowChange = \Canal\Protocol\RowChange::parseFromString($entry->getStoreValue()); foreach ($rowChange->getRowDatasList() as $rowData) { switch ($rowChange->getEventType()) { case \Canal\Protocol\EventType::INSERT: $this->handleInsert($rowData); break; case \Canal\Protocol\EventType::UPDATE: $this->handleUpdate($rowData); break; case \Canal\Protocol\EventType::DELETE: $this->handleDelete($rowData); break; } } } private function handleInsert($rowData) { $afterColumns = $rowData->getAfterColumnsList(); $data = []; foreach ($afterColumns as $column) { $data[$column->getName()] = $column->getValue(); } $this->syncToElasticsearch('index', $data); } private function handleUpdate($rowData) { $afterColumns = $rowData->getAfterColumnsList(); $data = []; $id = null; foreach ($afterColumns as $column) { $data[$column->getName()] = $column->getValue(); if ($column->getName() == 'id') { $id = $column->getValue(); } } $this->syncToElasticsearch('update', $data, $id); } private function handleDelete($rowData) { $beforeColumns = $rowData->getBeforeColumnsList(); $id = null; foreach ($beforeColumns as $column) { if ($column->getName() == 'id') { $id = $column->getValue(); break; } } $this->syncToElasticsearch('delete', null, $id); } private function syncToElasticsearch($operation, $data = null, $id = null) { try { switch ($operation) { case 'index': $params = [ 'index' => 'articles', 'id' => $data['id'], 'body' => $this->transformData($data) ]; $this->esClient->index($params); break; case 'update': $params = [ 'index' => 'articles', 'id' => $id, 'body' => [ 'doc' => $this->transformData($data) ] ]; $this->esClient->update($params); break; case 'delete': $params = [ 'index' => 'articles', 'id' => $id ]; $this->esClient->delete($params); break; } echo "同步成功: {$operation} ID: {$id}\n"; } catch (Exception $e) { echo "同步失败: {$e->getMessage()}\n"; $this->logFailure($operation, $id, $data); } } private function transformData($data) { return [ 'id' => (int)$data['id'], 'title' => $data['title'], 'content' => $data['content'], 'author' => $data['author'], 'category' => $data['category'], 'tags' => !empty($data['tags']) ? explode(',', $data['tags']) : [], 'status' => (int)$data['status'], 'created_at' => $data['created_at'], 'updated_at' => $data['updated_at'] ]; } private function logFailure($operation, $id, $data) { // 记录同步失败日志 file_put_contents( '/www/wwwlogs/canal_sync_failures.log', json_encode([ 'timestamp' => date('Y-m-d H:i:s'), 'operation' => $operation, 'id' => $id, 'data' => $data ]) . "\n", FILE_APPEND ); } } // 启动 Canal 客户端 $canalClient = new CanalClient(); $canalClient->startSync(); ?>五、方案四：数据库触发器 + 消息队列1. 创建消息表CREATE TABLE es_sync_queue ( id BIGINT AUTO_INCREMENT PRIMARY KEY, table_name VARCHAR(100) NOT NULL, record_id BIGINT NOT NULL, operation ENUM('INSERT', 'UPDATE', 'DELETE') NOT NULL, sync_status TINYINT DEFAULT 0 COMMENT '0:未同步, 1:已同步, 2:同步失败', created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_status (sync_status), INDEX idx_created (created_at) );2. 创建数据库触发器-- INSERT 触发器 DELIMITER $$ CREATE TRIGGER after_article_insert AFTER INSERT ON articles FOR EACH ROW BEGIN INSERT INTO es_sync_queue (table_name, record_id, operation, sync_status) VALUES ('articles', NEW.id, 'INSERT', 0); END$$ DELIMITER ; -- UPDATE 触发器 DELIMITER $$ CREATE TRIGGER after_article_update AFTER UPDATE ON articles FOR EACH ROW BEGIN INSERT INTO es_sync_queue (table_name, record_id, operation, sync_status) VALUES ('articles', NEW.id, 'UPDATE', 0); END$$ DELIMITER ; -- DELETE 触发器 DELIMITER $$ CREATE TRIGGER after_article_delete AFTER DELETE ON articles FOR EACH ROW BEGIN INSERT INTO es_sync_queue (table_name, record_id, operation, sync_status) VALUES ('articles', OLD.id, 'DELETE', 0); END$$ DELIMITER ;3. PHP 消息队列处理器<?php /** * 消息队列同步处理器 */ class QueueSyncService { private $db; private $esClient; public function __construct() { $this->initDatabase(); $this->esClient = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); } public function processQueue($batchSize = 100) { // 获取待同步的记录 $sql = "SELECT * FROM es_sync_queue WHERE sync_status = 0 ORDER BY id ASC LIMIT :limit FOR UPDATE"; $stmt = $this->db->prepare($sql); $stmt->bindValue(':limit', $batchSize, PDO::PARAM_INT); $stmt->execute(); $records = $stmt->fetchAll(); foreach ($records as $record) { $this->processRecord($record); } return count($records); } private function processRecord($record) { try { switch ($record['operation']) { case 'INSERT': case 'UPDATE': $this->syncUpsert($record); break; case 'DELETE': $this->syncDelete($record); break; } // 标记为已同步 $this->markAsSynced($record['id']); } catch (Exception $e) { // 标记为同步失败 $this->markAsFailed($record['id'], $e->getMessage()); } } private function syncUpsert($record) { // 从数据库获取最新数据 $data = $this->getRecordData($record['table_name'], $record['record_id']); if ($data) { $params = [ 'index' => $record['table_name'], 'id' => $record['record_id'], 'body' => $this->transformData($data) ]; $this->esClient->index($params); } } private function syncDelete($record) { $params = [ 'index' => $record['table_name'], 'id' => $record['record_id'] ]; $this->esClient->delete($params); } private function getRecordData($tableName, $recordId) { $sql = "SELECT * FROM {$tableName} WHERE id = :id"; $stmt = $this->db->prepare($sql); $stmt->execute([':id' => $recordId]); return $stmt->fetch(); } private function transformData($data) { // 根据表结构转换数据 if (isset($data['tags']) && !empty($data['tags'])) { $data['tags'] = explode(',', $data['tags']); } return $data; } private function markAsSynced($queueId) { $sql = "UPDATE es_sync_queue SET sync_status = 1 WHERE id = :id"; $stmt = $this->db->prepare($sql); $stmt->execute([':id' => $queueId]); } private function markAsFailed($queueId, $error) { $sql = "UPDATE es_sync_queue SET sync_status = 2, error_message = :error WHERE id = :id"; $stmt = $this->db->prepare($sql); $stmt->execute([ ':id' => $queueId, ':error' => $error ]); } public function retryFailed($batchSize = 50) { $sql = "SELECT * FROM es_sync_queue WHERE sync_status = 2 ORDER BY id ASC LIMIT :limit"; $stmt = $this->db->prepare($sql); $stmt->bindValue(':limit', $batchSize, PDO::PARAM_INT); $stmt->execute(); $records = $stmt->fetchAll(); $successCount = 0; foreach ($records as $record) { try { $this->processRecord($record); $successCount++; } catch (Exception $e) { // 记录重试失败 } } return $successCount; } } // 创建宝塔计划任务执行同步 $syncService = new QueueSyncService(); // 每次处理 100 条记录 $processed = $syncService->processQueue(100); echo "已处理 {$processed} 条同步记录"; // 重试失败的记录 $retried = $syncService->retryFailed(50); echo "重试成功 {$retried} 条记录"; ?>六、方案对比和选择建议方案选择指南场景推荐方案理由新建项目应用层双写代码可控，实时性最好已有项目，可修改代码应用层双写 + 全量初始化渐进式改造MySQL 数据库，要求高实时性Canal基于 Binlog，对业务无侵入简单同步，可接受分钟级延迟Logstash JDBC配置简单，稳定可靠数据库层面同步触发器 + 消息队列强一致性，对应用透明宝塔环境推荐配置对于大多数宝塔用户，我推荐：首选：应用层双写方案备选：Logstash JDBC 方案高级需求：Canal 方案性能优化建议// 批量操作优化 public function bulkSync($records) { $params = ['body' => []]; foreach ($records as $record) { $params['body'][] = [ 'index' => [ '_index' => 'articles', '_id' => $record['id'] ] ]; $params['body'][] = $this->transformData($record); } return $this->esClient->bulk($params); }选择最适合你项目需求和团队技术能力的方案。对于宝塔环境，应用层双写和 Logstash 方案相对更容易实施和维护。
IK 分词器安装指南是的，IK 分词器需要单独安装。 Elasticsearch 默认只提供标准分词器，对于中文分词效果不佳，IK 分词器是专门针对中文优化的分词插件。一、IK 分词器安装方法方法 1：手动安装（推荐）步骤 1：下载对应版本的 IK 分词器# 进入 Elasticsearch 插件目录 cd /www/server/elasticsearch/plugins # 创建 ik 目录 mkdir ik cd ik # 下载对应版本的 IK 分词器 # 注意：版本号必须与 Elasticsearch 版本一致！ # 查看 ES 版本：curl -X GET "localhost:9200/" wget https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.0/elasticsearch-analysis-ik-7.17.0.zip # 解压 unzip elasticsearch-analysis-ik-7.17.0.zip # 删除 zip 文件 rm -f elasticsearch-analysis-ik-7.17.0.zip # 返回插件目录上级，确保目录结构正确 cd .. ls -la ik/步骤 2：重启 Elasticsearch# 通过宝塔面板重启 # 或者使用命令 systemctl restart elasticsearch步骤 3：验证安装# 验证 IK 分词器是否安装成功 curl -X GET "localhost:9200/_cat/plugins?v" # 测试分词效果 curl -X POST "localhost:9200/_analyze" -H 'Content-Type: application/json' -d' { "analyzer": "ik_smart", "text": "中华人民共和国" }'正常响应：{ "tokens" : [ { "token" : "中华人民共和国", "start_offset" : 0, "end_offset" : 7, "type" : "CN_WORD", "position" : 0 } ] }方法 2：使用 Elasticsearch 插件命令安装# 进入 Elasticsearch 安装目录 cd /www/server/elasticsearch # 使用插件管理器安装 ./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.0/elasticsearch-analysis-ik-7.17.0.zip # 重启 Elasticsearch systemctl restart elasticsearch二、宝塔面板特有的安装方法通过宝塔终端操作打开宝塔面板 → 终端执行安装命令：# 切换到 elasticsearch 用户（宝塔环境可能需要） sudo -u elasticsearch /bin/bash # 进入 ES 插件目录 cd /www/server/elasticsearch/plugins # 下载并安装 IK 分词器 wget https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.0/elasticsearch-analysis-ik-7.17.0.zip unzip elasticsearch-analysis-ik-7.17.0.zip -d ik rm -f elasticsearch-analysis-ik-7.17.0.zip # 退出 elasticsearch 用户 exit # 重启 Elasticsearch 服务 systemctl restart elasticsearch宝塔文件管理器操作下载 IK 分词器：访问 IK 分词器 Releases下载对应版本的 ZIP 文件通过宝塔文件管理器上传：进入 /www/server/elasticsearch/plugins/创建 ik 文件夹上传 ZIP 文件到 ik 文件夹解压并删除 ZIP 文件重启服务：宝塔面板 → 软件商店 → Elasticsearch → 重启三、IK 分词器版本对应关系Elasticsearch 版本IK 分词器版本7.17.x7.17.07.16.x7.16.07.15.x7.15.07.14.x7.14.07.13.x7.13.07.12.x7.12.07.11.x7.11.07.10.x7.10.07.9.x7.9.0重要：必须确保版本一致，否则 Elasticsearch 无法启动！四、验证安装的完整脚本<?php /** * IK 分词器验证脚本 * 保存为 test_ik.php 并在浏览器访问 */ require '/www/wwwroot/your-site/vendor/autoload.php'; use Elasticsearch\ClientBuilder; class IKValidator { private $client; public function __construct() { $this->client = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); } /** * 检查 IK 分词器是否安装 */ public function checkIKInstallation() { echo " IK 分词器安装验证 "; // 1. 检查插件列表 echo " 1. 已安装插件列表 "; try { $plugins = $this->client->cat()->plugins(['v' => true]); echo " "; foreach ($plugins as $plugin) { echo $plugin . "\n"; if (strpos($plugin, 'analysis-ik') !== false) { echo "✅ IK 分词器已安装\n"; } } echo " "; } catch (Exception $e) { echo "❌ 获取插件列表失败: " . $e->getMessage() . "\n"; } // 2. 测试 IK 分词器功能 echo " 2. IK 分词器功能测试 "; $testTexts = [ "中华人民共和国", "北京大学生活动中心", " Elasticsearch中文分词器", "我喜欢吃苹果" ]; foreach ($testTexts as $text) { $this->testAnalyzer($text); } } /** * 测试分词器 */ private function testAnalyzer($text) { echo " 测试文本: \"{$text}\" "; // 测试 ik_smart（智能分词） echo "ik_smart 分词: "; $this->analyzeText($text, 'ik_smart'); // 测试 ik_max_word（细粒度分词） echo "ik_max_word 分词: "; $this->analyzeText($text, 'ik_max_word'); // 测试 standard（标准分词器对比） echo "standard 分词: "; $this->analyzeText($text, 'standard'); echo " "; } private function analyzeText($text, $analyzer) { try { $params = [ 'body' => [ 'analyzer' => $analyzer, 'text' => $text ] ]; $response = $this->client->indices()->analyze($params); echo "分析器: {$analyzer} "; echo "分词结果: "; foreach ($response['tokens'] as $token) { echo "" . $token['token'] . " "; } echo " "; } catch (Exception $e) { echo "❌ 分析器 {$analyzer} 不可用: " . $e->getMessage() . " "; } } /** * 创建测试索引验证 IK 分词器 */ public function createTestIndex() { $indexName = 'test_ik_index'; // 删除已存在的测试索引 if ($this->client->indices()->exists(['index' => $indexName])) { $this->client->indices()->delete(['index' => $indexName]); } // 创建使用 IK 分词器的索引 $params = [ 'index' => $indexName, 'body' => [ 'settings' => [ 'analysis' => [ 'analyzer' => [ 'ik_smart_analyzer' => [ 'type' => 'custom', 'tokenizer' => 'ik_smart' ], 'ik_max_analyzer' => [ 'type' => 'custom', 'tokenizer' => 'ik_max_word' ] ] ] ], 'mappings' => [ 'properties' => [ 'title' => [ 'type' => 'text', 'analyzer' => 'ik_smart_analyzer', 'search_analyzer' => 'ik_smart_analyzer' ], 'content' => [ 'type' => 'text', 'analyzer' => 'ik_max_analyzer', 'search_analyzer' => 'ik_smart_analyzer' ] ] ] ] ]; try { $response = $this->client->indices()->create($params); echo " 3. 测试索引创建 "; echo "✅ 测试索引创建成功，IK 分词器配置正常 "; // 测试索引文档 $doc = [ 'title' => 'Elasticsearch中文分词器测试', 'content' => '这是一个关于IK分词器的功能测试文档，用于验证中文分词效果。' ]; $this->client->index([ 'index' => $indexName, 'body' => $doc ]); echo "✅ 测试文档索引成功 "; } catch (Exception $e) { echo " 3. 测试索引创建 "; echo "❌ 创建测试索引失败: " . $e->getMessage() . " "; } } } // 执行验证 $validator = new IKValidator(); $validator->checkIKInstallation(); $validator->createTestIndex(); echo " 验证完成 "; echo "如果看到 IK 分词器正常工作，说明安装成功！"; ?>五、IK 分词器使用示例PHP 中使用 IK 分词器<?php require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; class IKSearchExample { private $client; public function __construct() { $this->client = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); } /** * 创建使用 IK 分词器的索引 */ public createNewsIndex() { $params = [ 'index' => 'news', 'body' => [ 'settings' => [ 'number_of_shards' => 1, 'number_of_replicas' => 0, 'analysis' => [ 'analyzer' => [ 'ik_smart_analyzer' => [ 'type' => 'custom', 'tokenizer' => 'ik_smart' ], 'ik_max_analyzer' => [ 'type' => 'custom', 'tokenizer' => 'ik_max_word' ] ] ] ], 'mappings' => [ 'properties' => [ 'title' => [ 'type' => 'text', 'analyzer' => 'ik_smart_analyzer', // 索引时使用智能分词 'search_analyzer' => 'ik_smart_analyzer' // 搜索时使用智能分词 ], 'content' => [ 'type' => 'text', 'analyzer' => 'ik_max_analyzer', // 索引时使用最大分词 'search_analyzer' => 'ik_smart_analyzer' // 搜索时使用智能分词 ], 'tags' => [ 'type' => 'text', 'analyzer' => 'ik_max_analyzer' ], 'author' => [ 'type' => 'keyword' // 关键字类型，不分词 ] ] ] ] ]; return $this->client->indices()->create($params); } /** * 使用 IK 分词器进行搜索 */ public function searchWithIK($keyword) { $params = [ 'index' => 'news', 'body' => [ 'query' => [ 'multi_match' => [ 'query' => $keyword, 'fields' => ['title^3', 'content^2', 'tags^2'], 'type' => 'best_fields' ] ], 'highlight' => [ 'fields' => [ 'title' => [ 'pre_tags' => [''], 'post_tags' => [''] ], 'content' => [ 'pre_tags' => [''], 'post_tags' => [''], 'fragment_size' => 150, 'number_of_fragments' => 3 ] ] ] ] ]; return $this->client->search($params); } } // 使用示例 $search = new IKSearchExample(); // 创建索引 $search->createNewsIndex(); // 搜索示例 $result = $search->searchWithIK('北京大学生'); print_r($result['hits']['hits']); ?>六、常见问题解决问题 1：版本不匹配症状：Elasticsearch 启动失败解决：# 检查错误日志 tail -f /www/server/elasticsearch/logs/elasticsearch.log # 如果看到版本不匹配错误，下载正确版本 cd /www/server/elasticsearch/plugins/ik rm -rf * wget https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v[正确版本]/elasticsearch-analysis-ik-[正确版本].zip unzip elasticsearch-analysis-ik-[正确版本].zip问题 2：权限问题症状：无法创建插件目录或文件解决：# 确保 elasticsearch 用户有权限 chown -R elasticsearch:elasticsearch /www/server/elasticsearch/plugins/ik chmod -R 755 /www/server/elasticsearch/plugins/ik问题 3：IK 分词器不生效症状：安装成功但分词效果不对解决：# 重启 Elasticsearch systemctl restart elasticsearch # 验证插件是否加载 curl -X GET "localhost:9200/_cat/plugins?v" # 检查索引配置是否正确使用了 IK 分词器七、IK 分词器扩展词典（可选）如果需要自定义词典，可以编辑 IK 配置文件：# 进入 IK 配置目录 cd /www/server/elasticsearch/plugins/ik/config # 编辑主词典 vi IKAnalyzer.cfg.xml # 添加自定义词典 # 在 <entry key="ext_dict">custom.dic</entry> # 创建自定义词典文件 vi custom.dic # 添加自定义词汇，每行一个词 区块链 人工智能 大数据记得安装完成后一定要重启 Elasticsearch 服务！这样就完成了 IK 分词器的安装和配置，现在可以在 PHP 代码中使用更优秀的中文搜索功能了。
1. 使用 Composer 安装# 安装 Composer（如果未安装） curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer # 创建项目目录 mkdir elasticsearch-php-demo cd elasticsearch-php-demo # 初始化 Composer composer init # 安装 Elasticsearch PHP 客户端 composer require elasticsearch/elasticsearch2. 手动安装（不使用 Composer）<?php // 手动引入 Elasticsearch 客户端 require_once 'path/to/elasticsearch-php/autoload.php';示例 1：基础连接和索引操作<?php require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; class ElasticsearchDemo { private $client; public function __construct() { // 创建 Elasticsearch 客户端 $this->client = ClientBuilder::create() ->setHosts(['localhost:9200']) // ES 服务器地址 ->setRetries(2) // 重试次数 ->build(); // 检查连接 if (!$this->checkConnection()) { throw new Exception("无法连接到 Elasticsearch"); } } /** * 检查 Elasticsearch 连接 */ private function checkConnection() { try { return $this->client->ping(); } catch (Exception $e) { echo "连接失败: " . $e->getMessage() . "\n"; return false; } } /** * 创建索引 */ public function createIndex($indexName) { $params = [ 'index' => $indexName, 'body' => [ 'settings' => [ 'number_of_shards' => 2, 'number_of_replicas' => 1 ], 'mappings' => [ 'properties' => [ 'title' => [ 'type' => 'text', 'analyzer' => 'standard' ], 'content' => [ 'type' => 'text', 'analyzer' => 'standard' ], 'author' => [ 'type' => 'keyword' ], 'publish_date' => [ 'type' => 'date' ], 'views' => [ 'type' => 'integer' ] ] ] ] ]; try { $response = $this->client->indices()->create($params); echo "索引 {$indexName} 创建成功\n"; return $response; } catch (Exception $e) { echo "创建索引失败: " . $e->getMessage() . "\n"; return false; } } /** * 删除索引 */ public function deleteIndex($indexName) { $params = ['index' => $indexName]; try { // 检查索引是否存在 if ($this->client->indices()->exists($params)) { $response = $this->client->indices()->delete($params); echo "索引 {$indexName} 删除成功\n"; return $response; } else { echo "索引 {$indexName} 不存在\n"; return false; } } catch (Exception $e) { echo "删除索引失败: " . $e->getMessage() . "\n"; return false; } } /** * 添加文档 */ public function addDocument($indexName, $document, $id = null) { $params = [ 'index' => $indexName, 'body' => $document ]; // 如果指定了 ID if ($id !== null) { $params['id'] = $id; } try { $response = $this->client->index($params); echo "文档添加成功，ID: " . $response['_id'] . "\n"; return $response; } catch (Exception $e) { echo "添加文档失败: " . $e->getMessage() . "\n"; return false; } } /** * 获取文档 */ public function getDocument($indexName, $id) { $params = [ 'index' => $indexName, 'id' => $id ]; try { $response = $this->client->get($params); return $response; } catch (Exception $e) { echo "获取文档失败: " . $e->getMessage() . "\n"; return false; } } /** * 更新文档 */ public function updateDocument($indexName, $id, $updateData) { $params = [ 'index' => $indexName, 'id' => $id, 'body' => [ 'doc' => $updateData ] ]; try { $response = $this->client->update($params); echo "文档更新成功\n"; return $response; } catch (Exception $e) { echo "更新文档失败: " . $e->getMessage() . "\n"; return false; } } /** * 删除文档 */ public function deleteDocument($indexName, $id) { $params = [ 'index' => $indexName, 'id' => $id ]; try { $response = $this->client->delete($params); echo "文档删除成功\n"; return $response; } catch (Exception $e) { echo "删除文档失败: " . $e->getMessage() . "\n"; return false; } } /** * 搜索文档 */ public function search($indexName, $query) { $params = [ 'index' => $indexName, 'body' => [ 'query' => $query ] ]; try { $response = $this->client->search($params); return $response; } catch (Exception $e) { echo "搜索失败: " . $e->getMessage() . "\n"; return false; } } /** * 批量插入文档 */ public function bulkInsert($indexName, $documents) { $params = ['body' => []]; foreach ($documents as $document) { $params['body'][] = [ 'index' => [ '_index' => $indexName ] ]; $params['body'][] = $document; } try { $response = $this->client->bulk($params); echo "批量插入完成，处理了 " . count($documents) . " 个文档\n"; return $response; } catch (Exception $e) { echo "批量插入失败: " . $e->getMessage() . "\n"; return false; } } } // 使用示例 try { $es = new ElasticsearchDemo(); // 创建索引 $es->createIndex('blog'); // 添加单个文档 $document = [ 'title' => 'Elasticsearch PHP 客户端使用指南', 'content' => '这是一篇关于如何使用 PHP 操作 Elasticsearch 的详细教程。', 'author' => '张三', 'publish_date' => '2023-10-01', 'views' => 100 ]; $es->addDocument('blog', $document, '1'); // 批量插入文档 $documents = [ [ 'title' => 'PHP 开发技巧', 'content' => '分享一些 PHP 开发中的实用技巧和最佳实践。', 'author' => '李四', 'publish_date' => '2023-10-02', 'views' => 150 ], [ 'title' => 'Linux 系统管理', 'content' => 'Linux 系统管理的基本命令和操作指南。', 'author' => '王五', 'publish_date' => '2023-10-03', 'views' => 200 ] ]; $es->bulkInsert('blog', $documents); // 搜索文档 $query = [ 'match' => [ 'title' => 'PHP' ] ]; $searchResult = $es->search('blog', $query); echo "搜索到 " . $searchResult['hits']['total']['value'] . " 个结果:\n"; foreach ($searchResult['hits']['hits'] as $hit) { echo "- " . $hit['_source']['title'] . " (作者: " . $hit['_source']['author'] . ")\n"; } } catch (Exception $e) { echo "错误: " . $e->getMessage() . "\n"; } ?>示例 2：高级搜索功能<?php require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; class AdvancedSearchDemo { private $client; public function __construct() { $this->client = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); } /** * 多字段搜索 */ public function multiFieldSearch($indexName, $keyword) { $params = [ 'index' => $indexName, 'body' => [ 'query' => [ 'multi_match' => [ 'query' => $keyword, 'fields' => ['title^2', 'content', 'author'], // title 字段权重为 2 'type' => 'best_fields' ] ], 'highlight' => [ 'fields' => [ 'title' => new \stdClass(), 'content' => new \stdClass() ] ] ] ]; return $this->client->search($params); } /** * 布尔搜索 */ public function boolSearch($indexName, $must = [], $should = [], $must_not = []) { $boolQuery = []; if (!empty($must)) { $boolQuery['must'] = $must; } if (!empty($should)) { $boolQuery['should'] = $should; } if (!empty($must_not)) { $boolQuery['must_not'] = $must_not; } $params = [ 'index' => $indexName, 'body' => [ 'query' => [ 'bool' => $boolQuery ] ] ]; return $this->client->search($params); } /** * 范围查询 */ public function rangeSearch($indexName, $field, $gte = null, $lte = null) { $range = []; if ($gte !== null) $range['gte'] = $gte; if ($lte !== null) $range['lte'] = $lte; $params = [ 'index' => $indexName, 'body' => [ 'query' => [ 'range' => [ $field => $range ] ] ] ]; return $this->client->search($params); } /** * 聚合查询 */ public function aggregationSearch($indexName) { $params = [ 'index' => $indexName, 'body' => [ 'size' => 0, // 不需要返回具体文档 'aggs' => [ 'authors' => [ 'terms' => [ 'field' => 'author.keyword', 'size' => 10 ] ], 'total_views' => [ 'sum' => [ 'field' => 'views' ] ], 'avg_views' => [ 'avg' => [ 'field' => 'views' ] ] ] ] ]; return $this->client->search($params); } } // 使用示例 $searchDemo = new AdvancedSearchDemo(); // 多字段搜索 $result = $searchDemo->multiFieldSearch('blog', 'PHP'); print_r($result['hits']); // 布尔搜索 $boolResult = $searchDemo->boolSearch('blog', [ // must 条件 ['match' => ['author' => '张三']], ['range' => ['views' => ['gte' => 50]]] ], [ // should 条件 ['match' => ['title' => '教程']], ['match' => ['content' => '指南']] ] ); // 聚合查询 $aggResult = $searchDemo->aggregationSearch('blog'); echo "总浏览量: " . $aggResult['aggregations']['total_views']['value'] . "\n"; echo "平均浏览量: " . $aggResult['aggregations']['avg_views']['value'] . "\n"; ?>示例 3：完整的博客搜索应用<?php require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; class BlogSearch { private $client; private $indexName = 'blog_posts'; public function __construct() { $this->client = ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); $this->createBlogIndex(); } private function createBlogIndex() { // 检查索引是否存在，不存在则创建 if (!$this->client->indices()->exists(['index' => $this->indexName])) { $params = [ 'index' => $this->indexName, 'body' => [ 'settings' => [ 'number_of_shards' => 1, 'number_of_replicas' => 1, 'analysis' => [ 'analyzer' => [ 'ik_smart_analyzer' => [ 'type' => 'custom', 'tokenizer' => 'ik_smart' ] ] ] ], 'mappings' => [ 'properties' => [ 'title' => [ 'type' => 'text', 'analyzer' => 'ik_smart_analyzer' ], 'content' => [ 'type' => 'text', 'analyzer' => 'ik_smart_analyzer' ], 'author' => [ 'type' => 'keyword' ], 'tags' => [ 'type' => 'keyword' ], 'category' => [ 'type' => 'keyword' ], 'publish_date' => [ 'type' => 'date' ], 'views' => [ 'type' => 'integer' ], 'status' => [ 'type' => 'keyword' ] ] ] ] ]; $this->client->indices()->create($params); } } public function addBlogPost($post) { $params = [ 'index' => $this->indexName, 'body' => $post ]; return $this->client->index($params); } public function searchPosts($keyword, $filters = [], $page = 1, $pageSize = 10) { $from = ($page - 1) * $pageSize; $query = [ 'bool' => [ 'must' => [], 'filter' => [] ] ]; // 关键词搜索 if (!empty($keyword)) { $query['bool']['must'][] = [ 'multi_match' => [ 'query' => $keyword, 'fields' => ['title^3', 'content^2', 'tags^2'], 'type' => 'best_fields' ] ]; } // 过滤器 foreach ($filters as $field => $value) { if (!empty($value)) { $query['bool']['filter'][] = [ 'term' => [$field => $value] ]; } } $params = [ 'index' => $this->indexName, 'body' => [ 'from' => $from, 'size' => $pageSize, 'query' => $query, 'sort' => [ ['publish_date' => ['order' => 'desc']], ['views' => ['order' => 'desc']] ], 'highlight' => [ 'fields' => [ 'title' => [ 'number_of_fragments' => 0 ], 'content' => [ 'fragment_size' => 150, 'number_of_fragments' => 3 ] ] ] ] ]; $response = $this->client->search($params); return [ 'total' => $response['hits']['total']['value'], 'posts' => $response['hits']['hits'], 'took' => $response['took'] ]; } public function getRelatedPosts($postId, $limit = 5) { // 先获取当前文章 $currentPost = $this->client->get([ 'index' => $this->indexName, 'id' => $postId ]); $tags = $currentPost['_source']['tags'] ?? []; if (empty($tags)) { return []; } $params = [ 'index' => $this->indexName, 'body' => [ 'size' => $limit, 'query' => [ 'bool' => [ 'must' => [ 'terms' => [ 'tags' => $tags ] ], 'must_not' => [ 'term' => [ '_id' => $postId ] ] ] ], 'sort' => [ ['views' => ['order' => 'desc']], ['publish_date' => ['order' => 'desc']] ] ] ]; $response = $this->client->search($params); return $response['hits']['hits']; } } // 使用示例 $blogSearch = new BlogSearch(); // 添加示例文章 $samplePosts = [ [ 'title' => 'PHP 8 新特性详解', 'content' => 'PHP 8 引入了许多令人兴奋的新特性，如命名参数、联合类型、属性等...', 'author' => '技术达人', 'tags' => ['PHP', '编程', '后端'], 'category' => '编程语言', 'publish_date' => '2023-09-15', 'views' => 245, 'status' => 'published' ], [ 'title' => 'Elasticsearch 入门教程', 'content' => '学习如何使用 Elasticsearch 进行全文搜索和数据聚合...', 'author' => '搜索专家', 'tags' => ['Elasticsearch', '搜索', '数据库'], 'category' => '数据库', 'publish_date' => '2023-09-20', 'views' => 189, 'status' => 'published' ] ]; foreach ($samplePosts as $post) { $blogSearch->addBlogPost($post); } // 搜索文章 $result = $blogSearch->searchPosts('PHP 教程', ['category' => '编程语言'], 1, 10); echo "找到 {$result['total']} 篇文章，耗时 {$result['took']} 毫秒\n"; foreach ($result['posts'] as $post) { echo "标题: " . $post['_source']['title'] . "\n"; if (isset($post['highlight'])) { echo "高亮: " . implode('...', $post['highlight']['content'] ?? []) . "\n"; } echo "---\n"; } ?>
使用方法 $wechatPayPlatformCertInstance = new \addons\unidrink\library\pay\overseas\wechat\Certificate(); try { $platformCerts = $wechatPayPlatformCertInstance->getPlatformCerts(); if (!empty($platformCerts)) { // 获取最新的证书 $latestCert = $platformCerts[0]; // 返回成功信息 return json([ 'code' => 1, 'msg' => '平台证书生成成功', 'data' => [ 'serial_no' => $latestCert['serial_no'], 'effective_time' => $latestCert['effective_time'], 'expire_time' => $latestCert['expire_time'], 'cert_saved_path' => $wechatPayPlatformCertInstance->getCertPath() . $latestCert['serial_no'] . '.pem', ] ]); } else { throw new Exception('未获取到平台证书'); } } catch (Exception $e) { // 错误处理 return json([ 'code' => 0, 'msg' => '平台证书生成失败: ' . $e->getMessage(), 'data' => [] ]); } 下面是类 <?php namespace addons\unidrink\library\pay\overseas\wechat; use think\Exception; use think\Log; use WeChatPay\Crypto\Rsa; use WeChatPay\Formatter; use WeChatPay\Util\PemUtil; class Certificate { // 配置参数 private $config; // 证书保存路径 private $certPath; // 平台证书列表 private $platformCerts = []; /** * 构造函数 * @param array $config 微信支付配置 */ public function __construct($config = []) { // 默认配置 $defaultConfig = [ 'mch_id' => '', // 商户号 'serial_no' => '', // 商户API证书序列号 'private_key' => ROOT_PATH . 'public/cert/apiclient_key.pem', // 商户私钥内容或路径 'api_v3_key' => '', // APIv3密钥 'cert_path' => ROOT_PATH . 'public/cert/wechatpay/', // 证书保存目录 'ca_cert_path' => ROOT_PATH . 'public/cert/cacert.pem' // CA证书路径 ]; $this->config = array_merge($defaultConfig, $config); $this->certPath = $this->config['cert_path']; // 验证APIv3密钥长度 $this->validateApiV3Key(); // 创建证书目录并确保权限 $this->prepareDirectories(); } /** * 准备目录并确保权限 */ private function prepareDirectories() { // 创建证书目录 if (!is_dir($this->certPath)) { if (!mkdir($this->certPath, 0755, true)) { throw new Exception('无法创建证书目录: ' . $this->certPath); } } // 检查证书目录权限 if (!is_writable($this->certPath)) { throw new Exception('证书目录不可写: ' . $this->certPath); } // 确保CA证书目录可写 $caCertDir = dirname($this->config['ca_cert_path']); if (!is_dir($caCertDir)) { if (!mkdir($caCertDir, 0755, true)) { throw new Exception('无法创建CA证书目录: ' . $caCertDir); } } if (!is_writable($caCertDir)) { throw new Exception('CA证书目录不可写: ' . $caCertDir); } } /** * 验证APIv3密钥长度是否正确 * APIv3密钥必须是32位字符串 * @throws Exception */ private function validateApiV3Key() { // 移除可能存在的空格 $apiV3Key = trim($this->config['api_v3_key']); // 重新设置清理后的密钥 $this->config['api_v3_key'] = $apiV3Key; // 检查长度 $keyLength = strlen($apiV3Key); if ($keyLength !== 32) { throw new Exception("APIv3密钥长度不正确，必须是32位，当前为{$keyLength}位"); } } /** * 获取平台证书 * @return array 平台证书列表 */ public function getPlatformCerts() { try { // 如果有缓存的证书且未过期，直接返回 $cachedCerts = $this->getCachedCerts(); if (!empty($cachedCerts)) { Log::info('使用缓存的平台证书，共' . count($cachedCerts) . '个'); return $cachedCerts; } Log::info('缓存的平台证书不存在或已过期，将从API获取'); // 从微信支付API获取证书 $this->fetchPlatformCerts(); // 缓存证书 $this->cacheCerts(); return $this->platformCerts; } catch (Exception $e) { Log::error('获取微信支付平台证书失败: ' . $e->getMessage() . '，堆栈信息: ' . $e->getTraceAsString()); throw new Exception('获取平台证书失败: ' . $e->getMessage()); } } /** * 从微信支付API获取平台证书 */ private function fetchPlatformCerts() { // 构建请求参数 $timestamp = time(); $nonce = $this->generateNonce(); $method = 'GET'; // $url = '/v3/certificates'; // 中国大陆境内 $url = '/v3/global/certificates'; // 注意：全球版API路径 $body = ''; Log::info("准备请求微信支付证书API: URL={$url}, 时间戳={$timestamp}, 随机串={$nonce}"); // 生成签名 $signature = $this->generateSignature($method, $url, $timestamp, $nonce, $body); // 构建授权头 $token = sprintf( 'WECHATPAY2-SHA256-RSA2048 mchid="%s",nonce_str="%s",timestamp="%d",serial_no="%s",signature="%s"', $this->config['mch_id'], $nonce, $timestamp, $this->config['serial_no'], $signature ); // 发送请求 $headers = [ 'Accept: application/json', 'User-Agent: FastAdmin/WechatPay', 'Authorization: ' . $token, ]; // 根据商户号判断使用国内还是国际API // $apiDomain = 'https://api.mch.weixin.qq.com'; $apiDomain = 'https://apihk.mch.weixin.qq.com'; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $apiDomain . $url); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10); curl_setopt($ch, CURLOPT_TIMEOUT, 30); // 检查私钥文件是否存在 $privateKeyPath = $this->config['private_key']; if (!file_exists($privateKeyPath)) { throw new Exception('私钥文件不存在: ' . $privateKeyPath); } // 检查私钥文件权限和内容 $this->validatePrivateKey($privateKeyPath); // 设置SSL选项 curl_setopt($ch, CURLOPT_SSLCERTTYPE, 'PEM'); curl_setopt($ch, CURLOPT_SSLKEYTYPE, 'PEM'); curl_setopt($ch, CURLOPT_SSLKEY, $privateKeyPath); // 获取并设置CA证书 $caCertPath = $this->getCACertPath(); if ($caCertPath && file_exists($caCertPath)) { curl_setopt($ch, CURLOPT_CAINFO, $caCertPath); Log::info('使用CA证书: ' . $caCertPath); } else { Log::warning('无法获取CA证书，临时关闭SSL验证'); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); } $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); $errorNumber = curl_errno($ch); $error = curl_error($ch); curl_close($ch); // 记录完整响应，便于调试 Log::info('微信支付平台证书API响应: HTTP状态码=' . $httpCode . ', 错误代码=' . $errorNumber . ', 错误信息=' . $error . ', 响应内容=' . $response); if ($httpCode !== 200) { // 特殊处理常见错误码 $errorMsg = "请求微信支付API失败，HTTP状态码: {$httpCode}"; switch ($httpCode) { case 401: $errorMsg .= "，可能是签名错误或商户信息不正确"; break; case 403: $errorMsg .= "，权限不足，可能是API未开通或IP白名单问题"; break; case 404: $errorMsg .= "，请求路径错误"; break; case 500: $errorMsg .= "，微信支付服务器内部错误"; break; } $errorMsg .= "，响应: {$response}"; throw new Exception($errorMsg); } if (empty($response)) { throw new Exception('微信支付API返回空响应'); } $data = json_decode($response, true); if (json_last_error() !== JSON_ERROR_NONE) { throw new Exception('解析微信支付API响应失败: ' . json_last_error_msg() . '，原始响应: ' . $response); } if (!isset($data['data']) || !is_array($data['data'])) { throw new Exception('微信支付API响应数据异常，未找到证书列表: ' . json_encode($data)); } if (empty($data['data'])) { throw new Exception('微信支付API返回空的证书列表'); } // 处理证书数据前记录原始数据 Log::info('准备处理的证书数据数量: ' . count($data['data']) . '，数据: ' . json_encode($data['data'])); // 处理证书数据 $this->processCertificates($data['data']); } /** * 验证私钥文件 */ private function validatePrivateKey($privateKeyPath) { // 检查文件权限 if (!is_readable($privateKeyPath)) { throw new Exception('私钥文件不可读: ' . $privateKeyPath); } // 检查文件大小 $fileSize = filesize($privateKeyPath); if ($fileSize < 100) { throw new Exception('私钥文件过小，可能不是有效的私钥: ' . $privateKeyPath); } // 检查私钥文件格式 $privateKeyContent = file_get_contents($privateKeyPath); if (strpos($privateKeyContent, '-----BEGIN PRIVATE KEY-----') === false || strpos($privateKeyContent, '-----END PRIVATE KEY-----') === false) { throw new Exception('私钥文件格式不正确，不是有效的PEM格式私钥'); } // 尝试加载私钥验证有效性 $key = openssl_pkey_get_private($privateKeyContent); if (!$key) { throw new Exception('私钥无效，无法加载: ' . openssl_error_string()); } // 检查密钥类型和长度 $keyDetails = openssl_pkey_get_details($key); if ($keyDetails['type'] !== OPENSSL_KEYTYPE_RSA || $keyDetails['bits'] < 2048) { throw new Exception('私钥必须是2048位或以上的RSA密钥'); } Log::info('私钥验证通过'); } /** * 获取CA证书路径 */ private function getCACertPath() { $caCertPath = $this->config['ca_cert_path']; // 如果CA证书不存在，则尝试下载 if (!file_exists($caCertPath)) { try { Log::info('CA证书不存在，尝试下载: ' . $caCertPath); $context = stream_context_create([ 'ssl' => [ 'verify_peer' => false, 'verify_peer_name' => false ], 'http' => [ 'timeout' => 10, ] ]); $cacert = file_get_contents('https://curl.se/ca/cacert.pem', false, $context); if ($cacert && strlen($cacert) > 10000) { // 确保下载到有效内容 file_put_contents($caCertPath, $cacert); Log::info('CA证书下载成功: ' . $caCertPath); return $caCertPath; } else { Log::error('下载的CA证书内容无效'); } } catch (Exception $e) { Log::error('下载CA证书失败: ' . $e->getMessage()); } } else { Log::info('使用已存在的CA证书: ' . $caCertPath); } return $caCertPath; } /** * 处理证书数据 * @param array $certificates 证书列表 */ private function processCertificates($certificates) { $successCount = 0; $errorDetails = []; foreach ($certificates as $index => $certInfo) { try { // 记录当前处理的证书信息 $serialNo = $certInfo['serial_no'] ?? '未知'; Log::info('处理第' . ($index + 1) . '个证书，序列号: ' . $serialNo); // 验证证书信息是否完整 if (!isset($certInfo['encrypt_certificate'])) { throw new Exception('缺少encrypt_certificate字段'); } $encryptCert = $certInfo['encrypt_certificate']; $requiredFields = ['ciphertext', 'nonce', 'associated_data']; foreach ($requiredFields as $field) { if (!isset($encryptCert[$field]) || empty($encryptCert[$field])) { throw new Exception("证书信息缺少{$field}字段"); } } // 解密证书 $cert = $this->decryptCertificate( $encryptCert['ciphertext'], $encryptCert['nonce'], $encryptCert['associated_data'] ); // 解析证书 $parsedCert = openssl_x509_parse($cert); if (!$parsedCert) { $error = openssl_error_string(); throw new Exception('解析证书失败: ' . $error); } // 验证证书有效期 $now = time(); $effectiveTime = strtotime($certInfo['effective_time'] ?? ''); $expireTime = strtotime($certInfo['expire_time'] ?? ''); if ($effectiveTime === false || $expireTime === false) { throw new Exception('证书有效期格式不正确'); } if ($now < $effectiveTime) { throw new Exception('证书尚未生效'); } if ($now > $expireTime) { throw new Exception('证书已过期'); } // 保存证书信息 $this->platformCerts[] = [ 'serial_no' => $serialNo, 'effective_time' => $certInfo['effective_time'], 'expire_time' => $certInfo['expire_time'], 'cert' => $cert, 'parsed_cert' => $parsedCert, ]; $successCount++; Log::info('成功处理证书，序列号: ' . $serialNo); } catch (Exception $e) { $errorMsg = '处理证书失败: ' . $e->getMessage(); $errorDetails[] = $errorMsg . '，证书信息: ' . json_encode($certInfo); Log::error($errorMsg); } } Log::info("证书处理完成，成功: {$successCount}个，失败: " . (count($certificates) - $successCount) . "个"); if (empty($this->platformCerts)) { throw new Exception('所有证书处理失败，没有可用的平台证书。详细错误: ' . implode('; ', $errorDetails)); } // 按过期时间排序，最新的在前面 usort($this->platformCerts, function ($a, $b) { return strtotime($b['expire_time']) - strtotime($a['expire_time']); }); } /** * 解密证书 * @param string $ciphertext 密文 * @param string $nonce 随机串 * @param string $associatedData 附加数据 * @return string 解密后的证书内容 */ private function decryptCertificate($ciphertext, $nonce, $associatedData) { // 记录解密参数，便于调试 Log::info("开始解密，nonce长度: " . strlen($nonce) . ", associatedData长度: " . strlen($associatedData) . ", 密文长度: " . strlen($ciphertext)); // 验证输入参数 if (empty($ciphertext)) { throw new Exception('密文为空'); } if (empty($nonce)) { throw new Exception('随机串为空'); } if (empty($associatedData)) { throw new Exception('附加数据为空'); } // 尝试解码base64 $decodedCiphertext = base64_decode($ciphertext, true); if ($decodedCiphertext === false) { throw new Exception('密文base64解码失败，可能不是有效的base64字符串'); } if (strlen($decodedCiphertext) < 10) { throw new Exception('解码后的密文长度过短，可能是无效数据'); } // 使用正确的AEAD_AES_256_GCM解密方法 // 微信支付使用的是AEAD_AES_256_GCM，需要正确处理认证标签 $ciphertext = base64_decode($ciphertext); $authTag = substr($ciphertext, -16); $ciphertext = substr($ciphertext, 0, -16); // 清除之前的OpenSSL错误 while (openssl_error_string() !== false) { } // 使用AEAD_AES_256_GCM解密 $cert = openssl_decrypt( $ciphertext, 'aes-256-gcm', $this->config['api_v3_key'], OPENSSL_RAW_DATA, $nonce, $authTag, $associatedData ); // 收集所有OpenSSL错误 $errors = []; while ($error = openssl_error_string()) { $errors[] = $error; } if ($cert === false) { throw new Exception('解密平台证书失败: ' . implode('; ', $errors) . '。检查APIv3密钥是否正确，密钥长度是否为32位'); } // 验证解密结果是否为有效的证书 if (strpos($cert, '-----BEGIN CERTIFICATE-----') === false || strpos($cert, '-----END CERTIFICATE-----') === false) { throw new Exception('解密结果不是有效的证书格式，可能是密钥错误'); } Log::info('证书解密成功，解密结果长度: ' . strlen($cert)); return $cert; } /** * 生成签名 * @param string $method 请求方法 * @param string $url 请求URL * @param int $timestamp 时间戳 * @param string $nonce 随机串 * @param string $body 请求体 * @return string 签名 */ private function generateSignature($method, $url, $timestamp, $nonce, $body) { $message = "{$method}\n{$url}\n{$timestamp}\n{$nonce}\n{$body}\n"; Log::info("生成签名的原始消息: " . base64_encode($message)); // 用base64避免特殊字符问题 // 加载私钥 $privateKey = $this->getPrivateKey(); // 生成签名 $signature = ''; $success = openssl_sign($message, $signature, $privateKey, OPENSSL_ALGO_SHA256); if (!$success) { throw new Exception('生成签名失败: ' . openssl_error_string()); } $signatureBase64 = base64_encode($signature); Log::info("生成签名成功: {$signatureBase64}"); return $signatureBase64; } /** * 获取私钥 * @return resource 私钥资源 */ private function getPrivateKey() { $privateKey = $this->config['private_key']; // 如果私钥是文件路径，读取文件内容 if (is_file($privateKey)) { $privateKey = file_get_contents($privateKey); } // 加载私钥 $key = openssl_pkey_get_private($privateKey); if (!$key) { throw new Exception('加载商户私钥失败: ' . openssl_error_string()); } return $key; } /** * 获取缓存的证书 * @return array 证书列表 */ private function getCachedCerts() { $cacheFile = $this->certPath . 'platform_certs.cache'; if (!file_exists($cacheFile)) { Log::info('平台证书缓存文件不存在: ' . $cacheFile); return []; } if (!is_readable($cacheFile)) { Log::warning('平台证书缓存文件不可读: ' . $cacheFile); return []; } $cacheData = json_decode(file_get_contents($cacheFile), true); if (json_last_error() !== JSON_ERROR_NONE) { Log::error('解析平台证书缓存失败: ' . json_last_error_msg()); return []; } if (!isset($cacheData['expire_time']) || !isset($cacheData['certs']) || !is_array($cacheData['certs'])) { Log::error('平台证书缓存格式不正确'); return []; } // 检查缓存是否过期（提前1小时刷新） $expireTime = $cacheData['expire_time']; $now = time(); if ($now >= ($expireTime - 3600)) { Log::info("平台证书缓存已过期或即将过期，当前时间: {$now}，过期时间: {$expireTime}"); return []; } return $cacheData['certs']; } /** * 缓存证书 */ private function cacheCerts() { if (empty($this->platformCerts)) { Log::warning('没有可缓存的平台证书'); return; } // 使用最早过期的时间作为缓存过期时间 $expireTime = time(); foreach ($this->platformCerts as $cert) { $certExpire = strtotime($cert['expire_time']); if ($certExpire > $expireTime) { $expireTime = $certExpire; } } $cacheData = [ 'expire_time' => $expireTime, 'certs' => $this->platformCerts, ]; $cacheFile = $this->certPath . 'platform_certs.cache'; $result = file_put_contents($cacheFile, json_encode($cacheData)); if ($result === false) { Log::error('保存平台证书缓存失败: ' . $cacheFile); } else { Log::info('平台证书缓存保存成功，有效期至: ' . date('Y-m-d H:i:s', $expireTime)); } // 保存证书文件 foreach ($this->platformCerts as $cert) { $certFile = $this->certPath . $cert['serial_no'] . '.pem'; if (file_put_contents($certFile, $cert['cert']) === false) { Log::error('保存平台证书文件失败: ' . $certFile); } else { Log::info('平台证书文件保存成功: ' . $certFile); } } } /** * 生成随机字符串 */ private function generateNonce($length = 16) { $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'; $nonce = ''; for ($i = 0; $i < $length; $i++) { $nonce .= $chars[random_int(0, strlen($chars) - 1)]; } return $nonce; } /** * 获取最新的平台证书 * @return string 证书内容 */ public function getLatestCert() { $certs = $this->getPlatformCerts(); if (empty($certs)) { throw new Exception('没有可用的平台证书'); } return $certs[0]['cert']; } /** * 根据序列号获取平台证书 * @param string $serialNo 证书序列号 * @return string 证书内容 */ public function getCertBySerialNo($serialNo) { $certs = $this->getPlatformCerts(); foreach ($certs as $cert) { if ($cert['serial_no'] === $serialNo) { return $cert['cert']; } } throw new Exception('找不到序列号为 ' . $serialNo . ' 的平台证书'); } /** * 获取配置参数 * @param string $key 配置键名 * @return mixed 配置值 */ public function getConfig($key = null) { if ($key === null) { return $this->config; } return isset($this->config[$key]) ? $this->config[$key] : null; } /** * 获取证书保存路径 * @return string 证书保存路径 */ public function getCertPath() { return $this->certPath; } }
PHP bc系列函数（高精度数学运算）简介：bc系列函数用于处理任意精度的十进制计算，适用于金融、科学计算等对精度要求极高的场景。需启用bcmath扩展（可通过phpinfo()检查是否启用）。特点：所有参数和返回值均为字符串类型（避免精度丢失）支持自定义小数位数（scale参数）提供基本运算、比较、幂运算等完整功能一、基础运算函数1. 加法：bcadd()// 语法：bcadd(左操作数, 右操作数, 保留小数位数) echo bcadd('123.456', '78.9', 2); // 202.36（123.456 + 78.9 = 202.356，保留2位小数） echo bcadd('100', '200', 0); // 300（整数相加）2. 减法：bcsub()// 语法：bcsub(被减数, 减数, 保留小数位数) echo bcsub('100.5', '30.25', 1); // 70.2（100.5 - 30.25 = 70.25，保留1位小数） echo bcsub('50', '75', 0); // -25（负数结果）3. 乘法：bcmul()// 语法：bcmul(乘数1, 乘数2, 保留小数位数) echo bcmul('2.5', '4.2', 2); // 10.50（2.5 × 4.2 = 10.5，保留2位小数） echo bcmul('100', '0.01', 0); // 1（整数与小数相乘）4. 除法：bcdiv()// 语法：bcdiv(被除数, 除数, 保留小数位数) echo bcdiv('10', '3', 3); // 3.333（10 ÷ 3 ≈ 3.3333...，保留3位） var_dump(bcdiv('5', '0', 0)); // false（除数为0时返回false）5. 取模（余数）：bcmod()// 语法：bcmod(被除数, 除数) echo bcmod('10', '3'); // 1（10 ÷ 3 余数为1） echo bcmod('7.5', '2.5'); // 0.0（7.5 是 2.5 的整数倍）二、比较函数bccomp()// 语法：bccomp(值1, 值2, 比较精度) // 返回值：1（值1 > 值2）、0（相等）、-1（值1 < 值2） echo bccomp('10', '10', 0); // 0（相等） echo bccomp('10.5', '10.49', 1); // 1（10.5 > 10.49，精确到1位小数） echo bccomp('5.999', '6', 2); // -1（5.999 < 6，精确到2位小数）三、幂运算与开方1. 幂运算：bcpow()// 语法：bcpow(底数, 指数, 保留小数位数) echo bcpow('2', '3', 0); // 8（2³ = 8） echo bcpow('1.2', '2', 2); // 1.44（1.2² = 1.44）2. 幂运算取模：bcpowmod()// 语法：bcpowmod(底数, 指数, 模数, 保留小数位数) // 作用：(base^exponent) % modulus，比先算幂再取模更高效 echo bcpowmod('3', '3', '5', 0); // 2（3³=27，27%5=2）3. 开平方：bcsqrt()// 语法：bcsqrt(数值, 保留小数位数) echo bcsqrt('25', 0); // 5（√25 = 5） echo bcsqrt('2', 4); // 1.4142（√2 ≈ 1.4142，保留4位） var_dump(bcsqrt('-4', 0)); // false（负数无法开平方）四、全局配置函数bcscale()// 功能：设置所有bc函数的默认小数位数（全局生效） bcscale(2); // 全局默认保留2位小数 echo bcadd('1', '2'); // 3.00（使用全局配置） echo bcsub('5', '3.5'); // 1.50（自动补全2位小数） echo bcadd('1', '2', 0); // 3（局部参数优先级高于全局）关键注意事项参数类型：必须传入字符串（如'123.45'），而非数字（避免自动转换导致精度丢失）。返回值：始终为字符串，需转换类型时用(float)或(int)。扩展依赖：需在php.ini中启用extension=bcmath（重启服务生效）。精度优先级：函数的scale参数 > bcscale()全局配置。通过这些函数，PHP可以实现高精度计算，解决普通数值类型精度不足的问题。
以下是一个包含 各种字段类型、约束条件、索引和特殊配置 的ThinkPHP8数据库迁移示例（以products产品表为例），覆盖常见场景：迁移文件示例（database/migrations/20250726153000_create_products_table.php）<?php use think\migration\Migrator; use think\migration\db\Column; class CreateProductsTable extends Migrator { /** * 执行迁移（创建表结构） */ public function change() { // 创建products表，配置表级参数 $table = $this->table('products', [ 'engine' => 'InnoDB', // 数据库引擎 'charset' => 'utf8mb4', // 字符集 'collation' => 'utf8mb4_unicode_ci', // 排序规则 'comment' => '产品表（包含多种字段类型示例）', // 表注释 'auto_increment' => 1000, // 自增ID起始值（MySQL支持） ]); // 字段定义（覆盖各种场景） $table // 1. 自增主键（整数型，无符号，自增） ->addColumn('id', 'integer', [ 'identity' => true, // 自增 'unsigned' => true, // 无符号（只存正数） 'comment' => '产品ID（主键）' ]) // 2. 字符串（有限长度，非空，唯一索引） ->addColumn('sku', 'string', [ 'limit' => 50, // 长度限制 'null' => false, // 非空（默认） 'comment' => '产品SKU（唯一标识）', 'unique' => true // 唯一约束 ]) // 3. 字符串（长文本，可空，带默认值） ->addColumn('name', 'string', [ 'limit' => 255, 'null' => false, 'default' => '', // 默认空字符串 'comment' => '产品名称' ]) // 4. 文本类型（无长度限制，可空） ->addColumn('description', 'text', [ 'null' => true, // 允许为空 'comment' => '产品详细描述' ]) // 5. 小数类型（高精度，带默认值） ->addColumn('price', 'decimal', [ 'precision' => 10, // 总位数 'scale' => 2, // 小数位数 'default' => 0.00, // 默认0.00 'comment' => '产品售价' ]) // 6. 整数类型（无符号，默认值，索引） ->addColumn('stock', 'integer', [ 'unsigned' => true, // 无符号（只存正数） 'default' => 0, // 默认库存0 'comment' => '库存数量', 'index' => true // 普通索引 ]) // 7. 枚举类型（固定可选值） ->addColumn('status', 'enum', [ 'values' => ['draft', 'active', 'disabled'], // 可选值 'default' => 'draft', // 默认草稿状态 'comment' => '产品状态（draft:草稿, active:上架, disabled:下架）' ]) // 8. 布尔类型（tinyint，默认true） ->addColumn('is_recommend', 'boolean', [ 'default' => true, // 默认true（1） 'comment' => '是否推荐（1:是, 0:否）' ]) // 9. 外键关联（整数，无符号，级联操作） ->addColumn('category_id', 'integer', [ 'unsigned' => true, 'null' => false, 'comment' => '所属分类ID', 'index' => true // 普通索引 ]) // 10. JSON类型（存储复杂结构，可空） ->addColumn('tags', 'json', [ 'null' => true, 'comment' => '产品标签（JSON格式，如["新品","热卖"]）' ]) // 11. 时间戳类型（自动维护） ->addTimestamps() // 自动添加 create_time 和 update_time（datetime类型） // 12. 软删除字段（自动维护删除时间） ->addSoftDelete() // 添加 delete_time 字段（软删除标识） // 13. 整数类型（排序权重，默认0） ->addColumn('sort', 'integer', [ 'default' => 0, 'comment' => '排序权重（值越大越靠前）' ]) // 添加外键约束（关联分类表） ->addForeignKey('category_id', 'categories', 'id', [ 'delete' => 'CASCADE', // 分类删除时，关联产品也删除 'update' => 'CASCADE' // 分类ID更新时，产品关联ID同步更新 ]) // 添加联合索引（名称+状态） ->addIndex(['name', 'status'], [ 'name' => 'idx_name_status' // 自定义索引名 ]) // 执行创建表 ->create(); } /** * 回滚迁移（删除表） */ public function down() { // 先删除外键约束（避免删除表失败） $this->table('products')->dropForeignKey('category_id'); // 再删除表 $this->dropTable('products'); } }关键字段配置说明字段名类型/配置核心特点id自增整数、主键无符号，自增起始值1000sku字符串、唯一约束唯一标识，非空，长度50name字符串、默认值非空，默认空字符串，用于产品名称description文本类型、可空无长度限制，允许为空（适合长文本描述）price小数(10,2)高精度价格，默认0.00stock无符号整数、索引库存数量，非负，普通索引提升查询效率status枚举类型固定可选值，默认草稿状态is_recommend布尔类型本质tinyint，默认true（1）category_id外键、级联操作关联分类表，删除/更新时级联处理tagsJSON类型存储数组/对象结构，适合非结构化数据create_time时间戳（自动维护）由addTimestamps()生成，记录创建时间delete_time软删除字段由addSoftDelete()生成，非NULL表示已删除执行迁移# 创建表 php think migrate:run # 回滚（删除表） php think migrate:rollback注意事项外键依赖：示例中category_id关联categories表，需确保categories表已存在（可先创建分类表迁移）。索引优化：根据查询场景添加索引，避免过度索引影响写入性能。软删除：addSoftDelete()会自动添加delete_time字段（datetime类型，默认NULL），适合逻辑删除。枚举值：修改枚举值需谨慎，生产环境可能需要先添加新值再迁移数据。字段注释：每个字段添加清晰注释，便于后期维护（尤其团队协作场景）。通过这个示例，可以覆盖ThinkPHP8迁移工具中绝大多数字段配置场景，实际开发中可根据需求调整。