ThinkPHP新手入门：Linux系统下手动编译安装Nginx与PHP-FPM【教程】

要在 Linux 上跑起 ThinkPHP，手动编译 Nginx 和 PHP-FPM 几乎是绕不开的一步。包管理器给的那些版本，不是太老就是缺扩展，尤其 OpCache、PDO MySQL、cURL 这些核心组件，缺一个后面就报错。下面这份实操流程，是我自己踩过坑之后梳理出来的，照着走，基本能一次过。

准备系统与编译依赖

先装基础编译工具和依赖库，不同发行版命令稍有区别，但核心包都一样。

Ubuntu/Debian 用户执行：sudo apt update && sudo apt install -y build-essential libpcre3-dev libssl-dev zlib1g-dev libxml2-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev libsqlite3-dev libonig-dev

CentOS/RHEL/AlmaLinux 用户执行：sudo dnf groupinstall "Development Tools" -y && sudo dnf install -y pcre-devel openssl-devel zlib-devel libxml2-devel curl-devel libjpeg-devel libpng-devel freetype-devel sqlite-devel oniguruma-devel

这里特别提一下 libonig-dev 或者 oniguruma-devel，很多人容易漏掉。如果不装，PHP 编译的时候大概率会报 configure: error: Unable to detect ICU prefix 或者正则相关的致命错误，导致 ThinkPHP 的路由解析直接罢工——这点务必留意。

编译安装Nginx

下载最新的稳定版 Nginx。截至2026年6月，1.26.1 是主流，直接拿下来：

wget https://nginx.org/download/nginx-1.26.1.tar.gz && tar zxf nginx-1.26.1.tar.gz && cd nginx-1.26.1

配置的时候，把常见的关键模块都带上，尤其是 SSL、HTTP/2、realip 这些，生产环境基本都会用到：

./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_stub_status_module --with-pcre

然后编译安装：make -j$(nproc) && sudo make install

为了方便用 systemd 管理，最好建一个 service 文件：sudo tee /etc/systemd/system/nginx.service，填入标准的 [Unit] [Service] [Install] 段，再执行 sudo systemctl daemon-reload。这样以后重启、停用就方便了。

编译安装PHP与PHP-FPM

ThinkPHP 7 官方推荐至少 PHP 8.2 以上，这里以 8.2.12 为例（当然你也可以用更新的版本，流程一样）：

wget https://www.php.net/distributions/php-8.2.12.tar.gz && tar zxf php-8.2.12.tar.gz && cd php-8.2.12

配置这一步最关键，必须确保所有 ThinkPHP 需要的扩展都编译进去，尤其注意以下参数：

./configure --prefix=/usr/local/php --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data --enable-opcache --enable-pdo --with-pdo-mysql --with-mysqli=mysqlnd --with-curl --with-gd --with-jpeg --with-png --with-freetype --with-zlib --with-openssl --with-gettext --with-iconv --enable-mbstring --enable-xml --enable-bcmath --enable-ctype --enable-tokenizer --enable-phar --enable-filter

这里有个容易翻车的点：必须确认 --enable-fpm 已经启用，而且 --with-fpm-user 设置的用户和后面 Nginx 运行的用户一致（通常是 www-data），否则 Nginx 转发请求时因为权限问题直接返回 502，排查起来很头疼。

配置无误后，编译安装：make -j$(nproc) && sudo make install

接着复制 FPM 的默认配置：sudo cp sapi/fpm/www.conf /usr/local/php/etc/php-fpm.d/www.conf && sudo cp sapi/fpm/php-fpm.conf /usr/local/php/etc/php-fpm.conf

启动 PHP-FPM：sudo /usr/local/php/sbin/php-fpm -y /usr/local/php/etc/php-fpm.conf

配置Nginx支持ThinkPHP的PATH_INFO与伪静态

首先在 Nginx 主配置文件 /usr/local/nginx/conf/nginx.conf 的 http 块里加上：

include /usr/local/nginx/conf/vhost/*.conf;

然后新建虚拟主机目录：sudo mkdir -p /usr/local/nginx/conf/vhost

接着创建 ThinkPHP 项目的虚拟主机配置文件 /usr/local/nginx/conf/vhost/thinkphp.conf，内容如下：

server {
    listen 80;
    server_name localhost;
    root /var/www/thinkphp/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}

注意：如果 PHP-FPM 监听的是 TCP 端口（例如 9000），就把 fastcgi_pass 改成 127.0.0.1:9000。不过从性能角度看，Unix socket 比 TCP 更高效，推荐使用 /run/php/php-fpm.sock，前提是 PHP-FPM 的 www.conf 里 listen 也设为同样的 socket 路径，并且权限设置正确（属于 www-data 用户和组）。

部署ThinkPHP并验证

先创建项目目录并设置好权限：sudo mkdir -p /var/www/thinkphp && sudo chown -R $USER:www-data /var/www/thinkphp

然后用 Composer 创建 ThinkPHP 7 项目（如果还没装 Composer，先全局安装）：cd /var/www/thinkphp && composer create-project topthink/think

接着修复 public 目录权限：sudo chmod -R 755 /var/www/thinkphp/public

重启服务使配置生效：sudo /usr/local/nginx/sbin/nginx -s reload && sudo /usr/local/php/sbin/php-fpm -y /usr/local/php/etc/php-fpm.conf -R

最后在浏览器里访问服务器 IP，看到 ThinkPHP 的默认欢迎页，就说明环境彻底跑通了。