Linux部署ThinkPHP核心是三件事:装对PHP8.0并配齐pdo_mysql、mbstring、openssl、fileinfo、opcache等扩展;Nginx根目录指向/public,伪静态规则为location / { try_files $uri $uri/ /index.php?$query_string; };runtime设775权限且属www-data组,.env置于根目录并关闭APP_DEBUG。

Linux上部署ThinkPHP不是安装软件,而是搭建适配的运行环境并正确放置项目。核心是三件事:装对版本的PHP(带必需扩展)、配好Web服务器(Nginx或Apache)指向public目录、设妥权限与配置。
选PHP版本并装齐关键扩展
ThinkPHP 6官方推荐PHP 8.0,TP8要求PHP ≥ 8.0.0;禁用PHP 8.3+,否则路由、函数调用会出错。扩展缺一不可:
- pdo_mysql 和 mysqli:数据库连接基础
- mbstring:多字节字符串处理,中文路径、编码依赖它
- openssl:HTTPS请求、加密功能必需
- fileinfo:文件类型检测,上传和资源加载要用
- opcache:必须启用,大幅提升性能
- libonig-dev(编译时):漏掉会导致正则匹配失败、路由解析中断
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
Nginx配置必须精准指向public
ThinkPHP入口在public/index.php,Web根目录绝不能设为项目根目录(如/var/www/myapp),否则app/、config/等敏感目录可能被直接访问。
- 站点配置中
root必须写成:root /var/www/myapp/public; - location块用标准伪静态规则:
location / { try_files $uri $uri/ /index.php?$query_string; } - 删掉所有
fastcgi_split_path_info相关行——TP不依赖它,留着反而导致PATH_INFO错乱 - 确认Nginx用户(如
www-data)对public/index.php有读权限:ls -l /var/www/myapp/public/index.php,权限不对就执行:sudo chown www-data:www-data /var/www/myapp/public/index.php
runtime权限与环境变量要锁死
500错误、白屏、缓存不生效,八成卡在这步。
-
runtime目录必须存在且可写:mkdir -p runtime && chmod -R 775 runtime && sudo chown -R www-data:www-data runtime - 加上
g+s保证新建文件继承组权限:chmod g+s runtime -
.env必须放在项目根目录(/var/www/myapp/.env),不能放public里;权限设为644,内容至少包含:APP_DEBUG = false<br>DATABASE_HOST = 127.0.0.1<br>DATABASE_NAME = your_db<br>DATABASE_USERNAME = root<br>DATABASE_PASSWORD = your_pass
- 确保PHP-FPM进程用户和Nginx用户一致(如都是
www-data),否则写入runtime失败
部署项目代码与验证
别用git clone直接拉到Web目录——容易暴露.git或配置文件。
- 用
scp或rsync传整个项目压缩包到/tmp,再解压到/var/www/myapp - 上传前本地清空
runtime/*,避免开发期缓存干扰 - 进项目根目录执行:
composer install --optimize-autoloader --no-dev
(跳过开发依赖,生成优化自动加载) - 浏览器访问域名,看到欢迎页即成功;若报错,先看
runtime/log/日志,再查Nginx错误日志/var/log/nginx/error.log
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











