10分钟内跑起laravel博客:先克隆项目并进入目录,再复制.env.example、生成密钥、安装依赖;接着配置数据库(db_port必须显式设为3306),执行迁移与填充;然后编译前端资源并启动服务。

想在10分钟内把Laravel博客项目跑起来,又不想被环境配置、权限报错、伪静态失效这些问题卡住?这篇教程只保留真正有效的操作路径,跳过所有理论铺垫和冗余说明。
本地快速启动 Laravel-blog 项目
第一步:克隆项目并进入目录
git clone https://gitcode.com/gh_mirrors/la/laravel-blog.git && cd laravel-blog
第二步:生成密钥并安装依赖
cp .env.example .env → php artisan key:generate → composer install
第三步:配置数据库连接
用编辑器打开 .env 文件,将 DB_DATABASE、DB_USERNAME、DB_PASSWORD 改成你本地 MySQL 实际值;【DB_PORT 必须显式写为 3306,哪怕你没改过端口,否则 migrate 会连接失败】
第四步:执行迁移并创建测试用户
php artisan migrate --seed
第五步:编译前端资源并启动服务
npm install → npm run dev → php artisan serve
宝塔面板一键部署 Laravel 站点
方法一:LNMP套件自动匹配环境
登录宝塔 → 软件商店 → 搜索“LNMP” → 安装时勾选 PHP 8.1+、fileinfo、opcache、openssl 扩展 → 等待安装完成
方法二:创建站点并设置伪静态
网站 → 添加站点 → 域名填 test.laravel.com(或你的真实域名)→ 根目录设为 /www/wwwroot/blog → PHP 版本选刚装好的 8.1 → 伪静态选项卡里直接选“Laravel5” → 保存
方法三:上传与权限配置
用宝塔文件管理器进入 /www/wwwroot/blog → 清空 index.html → 上传压缩包并解压 → 右键 storage 和 bootstrap/cache → 权限设为 755 → 【.env 文件必须手动编辑,APP_URL 要写成 https://test.laravel.com,不能留 http://localhost:8000】
生产环境 Nginx 配置关键项
① root 必须指向 public 目录:
root /var/www/myapp/public;
② try_files 规则不可省略:
location / { try_files $uri $uri/ /index.php?$query_string; }
③ PHP 处理块要匹配 socket 路径:
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
④ 防止 .env 泄露:
location ~ /\.(env|git|log)$ { deny all; }
⑤ 重启生效:
sudo nginx -t && sudo systemctl reload nginx
云函数部署 Laravel 的必要改造
第一步:新增 scf_bootstrap 启动脚本
在项目根目录新建文件 scf_bootstrap,内容为:
#!/bin/bash
export SERVERLESS=1
php artisan serve --host 0.0.0.0 --port 9000
第二步:赋予可执行权限
chmod 755 scf_bootstrap
第三步:重定向日志输出路径
由于 /tmp 是唯一可写目录,需在 scf_bootstrap 中加:
export LOG_PATH=/tmp/laravel.log
php artisan serve --host 0.0.0.0 --port 9000 > /tmp/laravel.log 2>&1
第四步:修改 storage 路径适配
在 config/filesystems.php 中,把 'root' => storage_path('app') 改为 'root' => '/tmp/storage/app'











