必须先手动编译安装PHP，因包管理器安装常缺mysqli、mbstring等扩展且无法精细配置FPM权限与OPcache；需更新系统、安装build-essential等工具链及libssl-dev等依赖库；下载解压php-8.2.12源码后，在其目录执行configure启用FPM、MySQLi、GD、OPcache等模块；再make -j4编译并sudo make install；最后复制php.ini-production，修改错误报告与时区，配置php-fpm.conf及www.conf并启动服务。
要在Linux服务器上运行ThinkPHP项目，必须先手动编译安装PHP，因为包管理器安装的PHP往往缺失mysqli、mbstring等关键扩展，且无法精确控制FPM用户权限和OPcache等生产级配置。
准备编译依赖与系统环境
执行以下命令更新系统并安装基础工具链：
sudo apt update && sudo apt install -y build-essential autoconf libtool pkg-config
安装PHP编译必需的开发库，缺一不可，否则configure阶段会报错中断：
sudo apt install -y libssl-dev libz-dev libcurl4-openssl-dev libxml2-dev libreadline-dev libsqlite3-dev libonig-dev libjpeg-dev libpng-dev libfreetype6-dev libgd-dev
这一步漏装libjpeg-dev或libpng-dev，后续启用GD库时会提示“cannot find jpeglib.h”或“png.h not found”，必须重装依赖后清理源码目录再重新configure。
立即学习“PHP免费学习笔记（深入）”；
下载并解压PHP源码
进入临时目录，下载PHP 8.2.12稳定版源码：
cd /tmp && wget https://www.php.net/distributions/php-8.2.12.tar.gz
解压并进入源码目录：
tar -zxvf php-8.2.12.tar.gz && cd php-8.2.12
【必须确保当前路径是php-8.2.12目录，否则后续configure将找不到configure脚本】
配置编译参数并生成Makefile
运行configure脚本，启用ThinkPHP必需的模块和路径设定：
./configure --prefix=/usr/local/php --with-config-file-path=/usr/local/php/etc --enable-fpm --with-fpm-user=www --with-fpm-group=www --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd --enable-mbstring --with-curl --with-gd --with-jpeg-dir=/usr --with-png-dir=/usr --with-freetype-dir=/usr --with-zlib --with-openssl --enable-opcache --enable-xml --enable-session
若出现“error: off_t undefined”类错误，说明libxml2-dev未生效，需重新安装该包并运行autoreconf -fiv后再试；若提示“Please reinstall the BZip2 distribution”，则补装libbz2-dev。
成功执行后末尾应显示“Thank you for using PHP.”，此时Makefile已就绪。
编译并安装PHP二进制文件
使用4线程加速编译：
make -j4
编译完成后执行安装：
sudo make install
这一步会把php、php-fpm等可执行文件复制到/usr/local/php/bin/和/usr/local/php/sbin/，同时创建默认配置目录结构。
初始化PHP配置与FPM服务
第一步：复制生产环境模板为php.ini：
sudo cp /tmp/php-8.2.12/php.ini-production /usr/local/php/etc/php.ini
第二步：编辑php.ini，启用错误报告并设及时区：
sudo sed -i 's/;error_reporting = E_ALL/error_reporting = E_ALL/g' /usr/local/php/etc/php.ini
sudo sed -i 's/;display_errors = Off/display_errors = On/g' /usr/local/php/etc/php.ini
sudo sed -i 's/;date.timezone =/date.timezone = Asia\/Shanghai/g' /usr/local/php/etc/php.ini
第三步：复制并配置PHP-FPM启动文件：
sudo cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
sudo cp /usr/local/php/etc/php-fpm.d/www.conf.default /usr/local/php/etc/php-fpm.d/www.conf
第四步：启动PHP-FPM服务：
sudo /usr/local/php/sbin/php-fpm
