宝塔面板新建Laravel站点需配置PHP≥8.0、开启必要扩展、关闭PATH_INFO,并将运行目录设为/public;上传完整项目后,还需设置.env、修复storage权限、应用Laravel伪静态规则。

直接在宝塔面板里新建一个支持 Laravel 的 Nginx 站点,核心不是“装 Laravel”,而是配置好符合 Laravel 运行要求的环境:PHP ≥ 8.0(推荐 8.1/8.2)、开启必要扩展(如 OpenSSL、PDO、Mbstring、Tokenizer、XML、Ctype、JSON)、关闭 PATH_INFO 模式,并把网站根目录指向 public 子目录。
一、创建站点前先确认环境就绪
进入宝塔「软件商店」,确保已安装:
- Nginx(最新稳定版即可)
- PHP(建议选 8.1 或 8.2,别用 7.4 及更早版本)
- MySQL(或 MariaDB,用于后续 Laravel 数据库)
点击 PHP 版本右侧的「设置」→「安装扩展」,勾选并安装:opcache、fileinfo、redis(可选但推荐)、exif、gd。特别注意:Laravel 要求 ctype、json、mbstring、openssl、pdo、tokenizer、xml、curl 这些必须启用——宝塔默认多数已开,但需手动核对。
二、添加站点并正确设置根目录
左侧菜单点「网站」→「添加站点」,填写:
- 域名:填你已解析好的域名(如 example.com),本地测试可用服务器 IP + 端口(不推荐长期用)
-
根目录:保持默认(如
/www/wwwroot/example.com),别改 - PHP 版本:选你刚确认好的 8.1 或 8.2
- 创建数据库:勾选,记下自动生成的用户名和密码(后面 Laravel 配置要用)
点「提交」后,站点即创建成功,但此时还不能直接放 Laravel 代码——因为默认根目录是整个项目目录,而 Laravel 必须通过 public/ 入口访问。
三、上传 Laravel 项目并调整运行入口
有两种常用方式:
-
方式1(推荐):上传完整 Laravel 项目到根目录,再修改网站配置
用宝塔「文件管理」进入/www/wwwroot/example.com,清空默认文件,上传你本地git clone或laravel new生成的整个项目(含app/、bootstrap/、public/等)。然后回到该站点「设置」→「网站目录」,把运行目录改为/public(注意开头不加斜杠,只填 public)。 -
方式2:直接把 Laravel 的 public 内容放到根目录(简化但不规范)
仅上传public/下所有文件(index.php、css、js 等)到根目录,并把.env、artisan等其他文件也一并传到根目录——这种方式绕过 Laravel 标准结构,后期升级或调用命令行会出问题,新手慎用。
四、关键配置补全与验证
站点建好后,还需几步才能正常访问:
-
设置 .env:在根目录上传或编辑
.env,填入数据库名、用户名、密码(对应建站时生成的数据库信息),并设APP_URL=http://example.com -
权限修复(重要):在「终端」中执行(或用宝塔文件管理器批量修改):
cd /www/wwwroot/example.com && chmod -R 755 storage/ bootstrap/cache/ && chown -R www:www storage/ bootstrap/cache/ -
伪静态规则(可选但推荐):站点设置 → 「伪静态」→ 选择「Laravel 5」模板,它会自动写入标准的 rewrite 规则,避免 URL 中出现
index.php -
打开调试看报错:首次访问白屏?进「网站」→「错误日志」查看 Nginx 或 PHP 错误;也可临时在
.env中设APP_DEBUG=true查具体提示
做完这些,浏览器访问你的域名,应该就能看到 Laravel 的欢迎页了。


















