PHP怎么部署到虚拟主机_PHP部署到虚拟主机准备【上线】

虚拟主机部署需确认php版本兼容性、清理本地残留文件、正确配置URL重写及通过错误日志定位500错误。

确认虚拟主机是否支持 PHP 及对应版本

很多虚拟主机默认开启 PHP，但版本可能较旧（如只支持 PHP 5.6），而你的项目依赖 PHP 7.4 或 PHP 8.1+ 就会直接报错——比如 Fatal Error: Uncaught Error: Call to undefined function mb_str_split()。先通过主机控制面板（cPanel / DirectAdmin）或联系客服确认已启用的 PHP 版本；部分主机还允许你在 .htaccess 中切换版本，例如：

php_value engine on AddHandler application/x-httpd-php81 .php

但注意：AddHandler 在某些 apache 配置下不生效，更可靠的方式是使用主机提供的“PHP 版本选择器”或修改 php.ini 路径配置。

上传文件前必须清理本地开发环境残留

本地用 XAMPP/MAMP/WAMP 开发时，常会生成 vendor/（composer 包）、node_modules/、.env.local、storage/logs/ 等目录——这些要么无用，要么含敏感配置或权限问题，上传后轻则 500 错误，重则泄露数据库密码。

• vendor/ 必须上传（除非主机支持 ssh + Composer，但绝大多数共享虚拟主机不支持）
• .env 文件需重命名为 .env.production 并手动填入线上数据库、密钥等，再通过 index.php 加载（laravel 用户注意：别用 php artisan config:cache，它依赖 Artisan 命令行，虚拟主机通常禁用）
• storage/ 和 bootstrap/cache/ 目录需设为 755 或 775（不是 777），且确保 Web 用户（如 nobody 或 www-data）有写权限

处理 URL 重写（尤其是 Laravel / thinkphp 类框架）

虚拟主机默认不开启 mod_rewrite，或虽开启但 .htaccess 被忽略。常见现象：首页能打开，点“关于我们”就 404。检查点：

立即学习“PHP免费学习笔记（深入）”；

• 确认 AllowOverride All 已在主机 Apache 配置中对网站根目录启用（用户无法改，需联系主机商确认）
• Laravel 的 .htaccess 必须放在 public/ 目录下，且整个项目应部署为：域名 → public/，而非项目根目录 → public/ 是子目录（否则重写规则失效）
• 如果主机仅支持 nginx（少见但存在），.htaccess 完全无效，需改用 Nginx 重写规则，但多数虚拟主机不提供 Nginx 配置入口，只能换主机或改用 PATH_INFO 模式（ThinkPHP 可设 'url_model' => 2）

调试 500 错误最有效的三步定位法

上传后白屏或提示 “500 internal Server Error”，别急着重传。按顺序查：

• 打开主机控制面板的「错误日志」（通常叫 Error Log 或 PHP Error Log），里面会明确写出哪行代码出错，比如：PHP Fatal error: Uncaught PDOException: SQLSTATE[HY000] [1045] Access denied for user 'db_user'@'localhost'
• 临时在 index.php 顶部加两行，强制显示错误（上线后务必删掉）：

• 检查 php.ini 是否禁用了关键扩展：如 mysqli、pdo_mysql、mbstring —— 某些主机默认关闭 mbstring，导致 jsON 解析或路由匹配失败

虚拟主机的限制比 VPS 严得多，很多看似 trivial 的问题（比如 file_put_contents() 写不到上级目录、gethostbyname() 被禁用）都得靠日志说话。别猜，先看日志。