当前位置：首页 > news >正文

PHPStudy2018环境部署全攻略

news 2026/8/27 9:45:00

📋PHPStudy网站部署攻略

一、部署环境准备

1.1 软件清单

软件	版本	用途	下载/安装方式
PHPStudy 2018	2018版	集成环境（推荐）	官网下载：https://www.xp.cn/download.html
Nginx	1.15.11	Web服务器（PHPStudy自带）	PHPStudy集成
PHP	5.6.27nts	脚本解析器（PHPStudy自带）	PHPStudy集成
MySQL	5.6	数据库（需单独切换）	PHPStudy软件管理中安装5.6版本
HeidiSQL / phpMyAdmin	-	数据库管理工具	PHPStudy自带phpMyAdmin

1.2 兼容性要点

PHP版本必须为5.6（网站基于ThinkPHP3.2.3开发）
MySQL必须用5.6（5.7以上可能存在兼容性问题）
Web服务器可选：最终采用Nginx（支持伪静态规则）

二、部署步骤

2.1 安装PHPStudy 2018

下载PHPStudy 2018版（不是8.1+版本）
安装路径：D:\phpStudy\PHPTutorial\（避免中文和空格）
启动后，在"软件管理"中安装MySQL 5.6
切换PHP版本为5.6.27nts

2.2 放置网站文件

网站根目录：D:\phpStudy\PHPTutorial\WWW\hn56at\

必须包含以下文件和目录：

index.php- 前台入口
admin.php- 后台入口
ThinkPHP/- 框架核心
Common/- 配置文件目录
Admin/- 后台模块
Index/- 前台模块
Uploads/- 附件目录（关键）
Public/- 静态资源目录

2.3 数据库配置

通过phpMyAdmin（http://localhost/phpMyAdmin/）创建数据库
导入网站数据文件xxx.sql
修改D:\phpStudy\PHPTutorial\WWW\hn56at\Common\Conf\config.php：

'DB_HOST'=>'localhost','DB_NAME'=>'数据库名','DB_USER'=>'root','DB_PWD'=>'root',

2.4 PHP配置修改

编辑D:\phpStudy\PHPTutorial\php\php-5.6.27-nts\php.ini：

; 关键1：禁用open_basedir限制（否则会报权限错误） ;open_basedir = /www/wwwroot/hn56at.com/:/tmp/:/proc/ ; 关键2：设置时区（消除警告） date.timezone = Asia/Shanghai ; 关键3：开启必要扩展 extension=php_mysql.dll extension=php_mysqli.dll extension=php_gd2.dll extension=php_curl.dll extension=php_mbstring.dll

重要：修改php.ini后必须重启PHP-CGI才能生效！

2.5 Nginx核心配置

文件位置：D:\phpStudy\PHPTutorial\nginx\conf\nginx.conf

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; root "D:/phpStudy/PHPTutorial/WWW"; # ===== 1. 静态文件处理（优先级最高） ===== location /Uploads/ { alias D:/phpStudy/PHPTutorial/WWW/hn56at/Uploads/; expires 30d; access_log off; # 关键：alias替换路径，不加break可能导致后续匹配 break; } location /Public/ { alias D:/phpStudy/PHPTutorial/WWW/hn56at/Public/; expires 30d; access_log off; break; } location /uploadfile/ { alias D:/phpStudy/PHPTutorial/WWW/hn56at/uploadfile/; expires 30d; access_log off; break; } # ===== 2. 根目录下的伪静态请求 ===== location / { # 捕获伪静态URL重定向到子目录 if ($request_uri ~ "^/(list|show|article)-\d+-\d+\.html") { rewrite ^/(.*)$ /hn56at/$1 permanent; } try_files $uri $uri/ @rewrite; } location @rewrite { rewrite ^/(.*)$ /hn56at/index.php?s=$1 last; } # ===== 3. 子目录处理（核心伪静态规则） ===== location /hn56at/ { index index.php index.html; # 关键：文件不存在才重写到index.php if (!-e $request_filename) { rewrite ^/hn56at/(.*)$ /hn56at/index.php?s=$1 last; } } # ===== 4. 根目录跳转 ===== location = / { return 302 /hn56at/; } # ===== 5. PHP解析 ===== location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } } }

三、关键问题及解决方案

3.1 open_basedir限制（最坑）

现象：访问PHP文件报错open_basedir restriction in effect
解决：php.ini中注释掉open_basedir，并重启PHP-CGI
注：phpStudy内置PHP-CGI重启phpStudy即可达到重启PHP-CGI的效果

3.2 图片404问题

现象：HTML中图片路径为/Uploads/xxx.jpg，但文件实际在/hn56at/Uploads/
解决：用alias做路径映射，而不是root

location /Uploads/ { alias D:/phpStudy/PHPTutorial/WWW/hn56at/Uploads/; }

3.3 伪静态404问题

现象：访问/list-28-1.html报404
解决：在子目录中配置rewrite规则，并用!-e判断文件是否存在

3.4 子目录访问问题

现象：直接访问/hn56at/显示403
解决：添加index index.php index.html;指定默认首页

3.5 PHP-CGI不生效问题

现象：修改php.ini后配置不生效
解决：必须重启PHP-CGI进程，不能只重启Nginx

taskkill /F /IM php-cgi.exe cd /d D:\phpStudy\PHPTutorial\php\php-5.6.27-nts php-cgi.exe -b 127.0.0.1:9000 -c php.ini

四、测试与验证

4.1 访问测试

首页跳转：http://localhost/→/hn56at/
图片访问：http://localhost/Uploads/2024-09-03/xxx.jpg
伪静态：http://localhost/hn56at/list-28-1.html
后台：http://localhost/hn56at/admin.php

4.2 常用命令

# 测试Nginx配置 cd /d D:\phpStudy\PHPTutorial\nginx nginx -t # 重启Nginx nginx -s reload # 完全重启Nginx nginx -s stop && nginx # 查看错误日志 type D:\phpStudy\PHPTutorial\nginx\logs\error.log