laravel运行报错主因是proc_open被禁用、站点根目录未指向public、open_basedir限制过严；需删除php禁用函数中的proc_open/putenv/pcntl_signal，将网站运行目录设为/public，调整open_basedir包含项目根目录及.composer路径，并重载配置。
直接装 Laravel 本身不难，难的是装完跑不起来——绝大多数报错都卡在 proc_open 被禁用、public 目录没设对、或 open_basedir 限制太死这三处。别急着敲 composer create-project，先调通环境。
PHP 禁用函数必须删掉 proc_open、putenv、pcntl_signal
Composer 安装 Laravel 或执行 php artisan 命令时，只要报 Call to undefined function proc_open() 或 putenv(): disabled，基本就是这个原因。宝塔默认为安全禁用这些函数，但 Laravel 的核心流程（如事件调度、队列、配置加载）依赖它们。
- 进宝塔 → 「软件管理」→ 找到你用的 PHP 版本 → 「设置」→ 「禁用函数」
- 把
proc_open、putenv、pcntl_signal从列表里删掉（注意不是打钩取消，是彻底删除） - 顺手检查下
shell_exec和exec是否也在列表里——Laravel Octane 或某些包需要，生产环境若不用可留着，开发阶段建议删 - 改完点「保存」，再点「重载配置」，否则不生效
站点根目录必须指向 public 子目录，不能是项目根目录
这是最常被忽略的一步。直接把整个 Laravel 项目上传到网站根目录，Nginx/Apache 会试图执行 index.php 外层的 artisan 或 vendor，导致 403/500 错误或敏感文件泄露。
- 新建站点时，在「网站目录」里填的路径，应该是类似
/www/wwwroot/myapp/public，不是/www/wwwroot/myapp - 如果已建好站点，进该站点「设置」→ 「网站目录」→ 把「运行目录」选成
/public（宝塔 8.x+ 支持下拉选择；老版本需手动改 Nginx 配置里的root行） - 确认 Nginx 配置中包含 Laravel 标准伪静态规则（宝塔新建站点时默认已加，但迁移旧项目时可能漏）：
location / { try_files $uri $uri/ /index.php?$query_string; }
Composer 安装 Laravel 要用面板终端，别在本地打包上传
本地用 composer create-project laravel/laravel 打包再传上去，容易因 Windows 换行符、权限丢失或 vendor 符号链接损坏导致运行异常。宝塔自带终端足够快，且能保证环境一致性。
- 进宝塔 → 「终端」→ 切到网站根目录：
cd /www/wwwroot/myapp - 执行安装命令（以 Laravel 11 + PHP 8.2 为例）：
php /www/server/php/82/bin/php /usr/bin/composer create-project laravel/laravel . --no-dev -
--no-dev是关键：跳过开发依赖，避免上线后vendor/bin下工具引发权限或路径问题 - 装完立刻执行：
php artisan key:generate，否则会报Application key not set - 检查
.env文件权限是否为 644，不能是 777（宝塔上传有时会设错）
open_basedir 限制要放开 ~/.composer 和项目路径
尤其在 PHP 8.0+ 上，Composer 全局缓存和 Laravel 的 storage、bootstrap/cache 目录常被 open_basedir 拦住，表现是日志写不进 storage/logs，或 php artisan config:cache 失败。
- 进 PHP 设置 → 「配置修改」→ 找到
open_basedir行 - 默认值通常是
/www/wwwroot/myapp:/tmp/:/proc/，把它改成：/www/wwwroot/myapp:/tmp/:/proc/:/root/.composer/:/home/www/.composer/（根据你系统用户是root还是www选对应路径） - 如果用了 Redis 或数据库连接池，还得加上 socket 路径，比如
/var/run/mysqld/mysqld.sock - 改完务必重载 PHP，不然白改
真正卡住人的从来不是“怎么装”，而是装完发现 php artisan 命令在终端能跑，但网页打开就 500，或者日志空空如也——这时候八成是 open_basedir 没放行 storage，或者 proc_open 还在禁用列表里躺着。多看一眼错误日志路径，比重装三遍环境更省时间。
