Windows 环境下 Nginx、PHP 与 ThinkPHP 开发环境搭建

1. 安装 Nginx 和 PHP

安装 Nginx

1. 访问 Nginx 官网下载 Windows 版本

2. 解压到指定目录，如 C:\nginx

安装 PHP

1. 访问 PHP 官网下载 PHP（推荐 PHP 7.4 或更高版本）

2. 选择 Non Thread Safe (NTS) x64 版本

3. 解压到指定目录，如 C:\php

2. 配置 Nginx

基本配置

编辑 nginx/conf/nginx.conf 文件：

#user  nobody;

worker_processes  1;



events {

    worker_connections  1024;

}



http {

    include       mime.types;

    default_type  application/octet-stream;

    sendfile        on;

    keepalive_timeout  65;



    server {

        listen       80;

        server_name  localhost;



        location / {

            root   C:/wwwroot/phpnginx/thinkphp_layui/public;

            index  index.html index.htm index.php;

            

            # ThinkPHP 伪静态规则

            if (!-e $request_filename) {

                rewrite ^(.*)$ /index.php?s=$1 last;

                break;

            }

        }



        # 启用 PHP 脚本处理

        location ~ \.php$ {

            root           C:/wwwroot/phpnginx/thinkphp_layui/public;

            fastcgi_pass   127.0.0.1:9000;

            fastcgi_index  index.php;

            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;

            include        fastcgi_params;

            fastcgi_buffers 16 16k;

            fastcgi_buffer_size 32k;

        }

    }

}

注意事项

路径使用正斜杠 / 而非反斜杠 \
确保 root 指向正确的 ThinkPHP 项目 public 目录
伪静态规则对 ThinkPHP 路由至关重要

3. 配置 PHP

创建 php.ini 文件

1. 复制 PHP 目录中的 php.ini-development 为 php.ini

2. 编辑 php.ini 文件，启用必要的扩展：

extension_dir = "ext"



; 取消以下扩展前的注释（删除分号）

extension=curl

extension=fileinfo

extension=gd

extension=mbstring

extension=openssl

extension=pdo_mysql

extension=mysqli



; 设置时区

date.timezone = Asia/Shanghai

配置 PHP-FPM

1. 在 PHP 目录中找到 php-fpm.conf.default，复制为 php-fpm.conf

2. 编辑 php-fpm.conf，确保监听地址为：

listen = 127.0.0.1:9000

4. 启动服务

启动 PHP-FPM

打开命令提示符，执行：

cd C:\php

php-cgi.exe -b 127.0.0.1:9000

或者如果使用 PHP-FPM：

cd C:\php

php-fpm.exe

启动 Nginx

打开新的命令提示符，执行：

cd C:\nginx

start nginx

5. ThinkPHP 配置

项目目录结构

确保 ThinkPHP 项目结构如下：

thinkphp_layui/

├── app/

├── config/

├── extend/

├── public/

│   ├── index.php

│   ├── static/

│   └── ...

├── runtime/

├── vendor/

└── ...

数据库配置

编辑 config/database.php 文件：

return [

    // 默认使用的数据库连接配置

    'default'         => env('database.driver', 'mysql'),



    // 数据库连接配置信息

    'connections'     => [

        'mysql' => [

            // 数据库类型

            'type'              => env('database.type', 'mysql'),

            // 服务器地址

            'hostname'          => env('database.hostname', '127.0.0.1'),

            // 数据库名

            'database'          => env('database.database', 'thinkphp'),

            // 用户名

            'username'          => env('database.username', 'root'),

            // 密码

            'password'          => env('database.password', ''),

            // 端口

            'hostport'          => env('database.hostport', '3306'),

            // 数据库连接参数

            'params'            => [],

            // 数据库编码默认采用utf8

            'charset'           => env('database.charset', 'utf8'),

            // 数据库表前缀

            'prefix'            => env('database.prefix', ''),

        ],

    ],

];

环境配置

在项目根目录创建 .env 文件：

APP_DEBUG = true



[DATABASE]

TYPE = mysql

HOSTNAME = 127.0.0.1

DATABASE = thinkphp

USERNAME = root

PASSWORD = your_password

HOSTPORT = 3306

CHARSET = utf8

PREFIX = tp_

6. 常见问题排查

"No input file specified" 错误

检查 Nginx 配置中的 root 路径是否正确
确保 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 配置正确
检查 PHP-FPM 是否正在运行

PHP 扩展缺失

如果安装页面提示缺少扩展，编辑 php.ini 文件启用相应扩展，然后重启 PHP-FPM。

权限问题

确保 Nginx 和 PHP-FPM 有足够权限访问项目文件。

日志检查

Nginx 错误日志：C:\nginx\logs\error.log
PHP 错误日志：在 php.ini 中配置 error_log 指令

端口冲突

如果 80 端口被占用，可以修改 Nginx 配置使用其他端口，如 8080。

Nginx 常用命令

重新加载配置：nginx -s reload
停止服务：nginx -s stop
测试配置文件：nginx -t

设置为 Windows 服务（可选）

使用 NSSM 工具可以将 Nginx 和 PHP-FPM 设置为 Windows 服务，实现开机自启动。