需配置PHP 8.1+、必要扩展及Nginx伪静态;通过宝塔软件商店安装PHP并启用扩展,创建站点时设运行目录为/public、伪静态选Laravel5,用Composer一键拉取项目,再设storage与bootstrap/cache权限为775、配置.env为production环境、生成密钥并清缓存。

在宝塔面板上快速部署Laravel框架,省去手动编译PHP、配置Nginx伪静态、调整目录权限等繁琐步骤,直接获得可运行的生产就绪环境。整个过程无需SSH反复调试,不依赖本地开发机,从创建站点到访问首页不超过5分钟。
安装兼容PHP版本与必要扩展
进入宝塔「软件商店」→ 搜索“PHP”,找到PHP 8.1或8.2版本(【Laravel 10+强制要求PHP ≥ 8.1】)→ 点击安装→ 勾选openssl、pdo、mbstring、tokenizer、xml、ctype、json、zip扩展→ 安装完成并重启PHP服务。
安装完成后,在终端执行php -m | grep -E "openssl|mbstring|tokenizer"验证扩展已启用;若缺失任一模块,返回PHP管理页面补装并再次重启PHP-FPM。
创建站点并设置Laravel专用路径
点击左侧「网站」→「添加站点」→ 填写域名(如test.laravel.local,本地hosts可映射127.0.0.1)→ 根目录设为/www/wwwroot/test.laravel.local→ PHP版本选择刚安装的8.1或8.2。
站点创建成功后,立即进入该站点「设置」→「网站目录」→ 将「运行目录」下拉选择/public→ 点击保存。这一步不可跳过,否则所有路由返回404。
接着切换到「伪静态」选项卡→ 下拉选择「Laravel 5」→ 保存。该规则会自动注入Nginx配置,适配Laravel 5至13全系列路由机制。
一键拉取并初始化Laravel项目
方法一:使用Composer命令行(推荐)
在宝塔「终端」中执行:cd /www/wwwroot/test.laravel.local → composer create-project laravel/laravel . --no-dev
方法二:用Docker快速启动(需已启用Docker)curl -s https://laravel.build/test-app | bash → 自动解压至当前目录 → 执行mv test-app/* . && rm -rf test-app
注意:若提示“command not found: composer”,先在软件商店安装Composer,或执行wget https://getcomposer.org/installer -O composer-setup.php && php composer-setup.php --install-dir=/www/server/php/81/bin --filename=composer手动部署。
配置关键运行参数
第一步:设置目录权限
在文件管理器中,右键点击storage和bootstrap/cache两个文件夹 → 「权限」→ 数字权限填入775 → 勾选“递归设置子目录和文件” → 确认。
第二步:生成.env并配置环境
点击根目录下的.env.example → 右键「复制」→ 粘贴并重命名为.env → 点击编辑 → 修改APP_ENV=production、APP_DEBUG=false、APP_URL=https://test.laravel.local(协议与域名须匹配)→ 保存。
第三步:生成密钥并清缓存
回到终端 → cd /www/wwwroot/test.laravel.local → php artisan key:generate → php artisan config:clear && php artisan cache:clear && php artisan view:clear。


















