虚拟主机部署需确认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。检查点：
MCShop V3.0发布以来，收到部分希望使用虚拟主机用户反馈，MVC架构部署复杂，微维网络特推出非MVC MCShop V3.06版本满足希望使用普通虚拟主机用户，建议有条件的用户使用MCShop V3.0 MVC版本。 MCShop 微维B2C网上商城系统独立网店系统是，北京微维网络开发的一套成熟b2c网上商城电子商务解决方案。 系统基于广受赞誉的成熟解决方案MCShop。 系
立即学习“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 error_reporting(E_ALL); ini_set('display_errors', '1'); ?> - 检查
php.ini是否禁用了关键扩展：如mysqli、pdo_mysql、mbstring—— 某些主机默认关闭mbstring，导致 JSON 解析或路由匹配失败
虚拟主机的限制比 VPS 严得多，很多看似 trivial 的问题（比如 file_put_contents() 写不到上级目录、gethostbyname() 被禁用）都得靠日志说话。别猜，先看日志。
