共享主机可运行Symfony，需本地构建全量项目包上传并手动配置环境：确保PHP版本兼容、上传含vendor目录、设APP_ENV=prod、强制环境变量、禁用WebProfilerBundle、预热缓存、配置数据库及保护.env文件。
共享主机通常禁用命令行、禁止执行 composer install、不开放端口、无法写入系统路径，甚至屏蔽 exec() 和 shell_exec()。这种环境下不能用 Symfony CLI 或本地构建再上传整套 vendor——但项目仍可创建，关键是“绕过运行时依赖安装，把构建过程前移到本地”。
核心思路：本地构建 + 全量上传 + 环境适配
共享主机不是不能跑 Symfony，而是不能“现场安装”。所以必须在本地完整生成可直接运行的项目包，上传后仅需极简配置即可访问。
- 用
symfony new myapp --webapp在本地生成带public/、vendor/、预设.env的完整项目 - 确保本地 PHP 版本 ≥ 主机支持的最低版本（如 8.1），避免运行时语法报错
- 上传整个项目目录（含
vendor），**不要删 vendor 或只传源码** - 检查主机是否支持
mod_rewrite（Apache）或try_files（Nginx 代理），否则路由 404
关键配置手动补全（主机不支持 Flex 自动配置）
共享主机往往禁用 Flex 的 runtime 配置能力，需人工确认并修正以下三项：
-
.env文件中必须包含：APP_ENV=prod（非 dev）、APP_DEBUG=0（关闭调试）、APP_SECRET=your_random_secret_here（不可为空） -
public/index.php开头需显式强制环境：在require __DIR__.'/../vendor/autoload.php';后加一行：$_ENV['APP_ENV'] = $_SERVER['APP_ENV'] = 'prod'; -
禁用 WebProfilerBundle：打开
config/bundles.php，删除或注释掉Symfony\WebpackEncoreBundle\WebpackEncoreBundle::class => ['all' => true],及Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true],—— 这些在 prod 环境下会因权限或扩展缺失报错
静态资源与缓存处理
共享主机常限制 var/cache 写入权限或自动清空临时目录，导致首次访问白屏或 500 错误：
- 本地执行
php bin/console cache:warmup --env=prod，生成完整缓存文件后再上传var/cache/prod/目录 - 将
var/cache和var/log设为可写（通过 FTP 客户端或主机控制面板 chmod 755 或 775） - 若主机禁用
opcache或apcu，可在config/packages/framework.yaml中显式关闭：php_errors: { log: true }并移除cache:下所有 adapter 配置，回退到 filesystem 缓存
数据库连接与 .env 安全
共享主机数据库通常只提供一个 MySQL 实例和固定账号，且不允许创建新用户：
- 在
.env中填写主机提供的 DB_HOST（常为localhost或具体 IP）、DB_NAME、DB_USER、DB_PASSWORD - 用
php bin/console doctrine:database:create --if-not-exists本地验证连接字符串有效（上传后无需再运行） -
务必通过主机控制面板或 .htaccess 禁止直接访问
.env：在public/.htaccess末尾加：RedirectMatch 404 /\.env$
