PHP8.5新项目环境搭建：Nginx、PHP-FPM、Composer一次配置-php教程-PHP中文网

php 8.5在windows下需用nts版搭配nginx+php-fpm：解压配置php.ini（启用扩展、opcache）、nginx通过fastcgi_pass转发至127.0.0.1:9000、composer仅构建阶段运行并禁用生产环境命令，同时加固nginx禁止访问.env/vendor等敏感路径。

php8.5新项目环境搭建：nginx、php-fpm、composer一次配置

PHP 8.5 新项目环境搭建，核心是让 Nginx、PHP-FPM、Composer 三者各司其职且互不干扰：Nginx 负责接收请求并分发，PHP-FPM 真正执行 PHP 代码，Composer 则只在构建阶段管理依赖，绝不进入生产运行流程。

PHP 8.5 安装与 FPM 基础配置

去 windows.php.net 下载 PHP 8.5.x NTS（Non-Thread Safe）Zip 包——这是搭配 Nginx + PHP-FPM 的唯一推荐版本。解压到固定路径，如 C:\php。

复制 php.ini-development 为 php.ini，重点修改以下几项：

extension_dir = "ext"（确认扩展目录路径正确）
date.timezone = Asia/Shanghai
启用关键扩展：extension=mysqli、extension=mbstring、extension=openssl、extension=curl（去掉前面的分号）
开启 OPcache：opcache.enable=1、opcache.memory_consumption=256、opcache.max_accelerated_files=20000、opcache.validate_timestamps=0（开发时可设为 1，上线后必须为 0）

将 C:\php 加入系统环境变量 Path，命令行输入 php -v 和 php --ri opcache 验证是否生效。

Nginx 配置 PHP 请求转发

下载 Nginx Windows 版（推荐 1.24+），解压后编辑 conf/nginx.conf，在 http 块内确保已加载 fastcgi_params；在 server 块中添加或替换 PHP 处理段：

location ~ \.php$ {
    root           html;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

注意：root 必须与你的项目实际路径一致（例如改为 root C:/www/myproject;），否则 $document_root 解析错误会导致 404 或 502。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

启动 PHP-FPM：php-cgi.exe -b 127.0.0.1:9000（前台运行测试用），或使用 php-fpm.exe（需配套 php-fpm.conf，Windows 下建议先用 -b 快速验证）。

Composer 安装与项目级隔离

下载 Composer-Setup.exe，安装时勾选“Add to PATH”，完成后运行 composer -V 确认。

在项目根目录执行初始化：

composer init（按提示填写包名、描述等）
composer require monolog/monolog（示例引入依赖）
生成优化版自动加载：composer install --no-dev --optimize-autoloader --classmap-authoritative

关键原则：所有 composer install 必须在本地或 CI 构建机完成，生成完整 vendor/ 目录后整体同步至部署目标；生产服务器上禁止保留 composer.phar 或开放 composer 命令。

Nginx 安全加固（防暴露 & 防误访）

在站点 server 块中追加以下规则，防止敏感文件被直接下载：

location ~ /\.(env|json|lock|git|hg|svn|log)$ {
    deny all;
}
location ^~ /vendor/ {
    return 403;
}
location ^~ /storage/ {
    return 403;
}
location ^~ /bootstrap/cache/ {
    return 403;
}

若项目采用 Laravel 等框架，务必把 root 指向 public/ 目录，而非项目根目录，避免 .env 等配置文件暴露。