一键部署Laravel项目PHP环境教程

想要快速部署 Laravel 项目？本文为你提供一份详细的**一键 PHP 环境部署 Laravel 项目教程**，以宝塔面板为例，手把手教你轻松搞定。首先，你需要将网站根目录指向 public 文件夹，这是 Laravel 项目的关键入口。接着，上传项目代码，并通过 `composer install` 安装依赖，生成应用密钥。配置好数据库连接信息，并确保 storage 和 bootstrap/cache 目录拥有写入权限。最后，启用伪静态规则，让你的 URL 更加美观。通过本教程，即使是新手也能在宝塔面板等一键 PHP 环境中快速部署 Laravel 项目，解决常见问题，让你的项目顺利上线！别再犹豫，快来学习吧！

部署Laravel项目到宝塔面板需配置网站根目录指向public，上传代码后运行composer install、生成密钥、配置数据库及权限，启用伪静态规则，确保storage和cache目录可写，最后通过日志排查错误。

部署 Laravel 项目到一键 PHP 环境（如宝塔面板、phpStudy、WampServer 等）其实并不复杂，只要配置好路径、权限和环境依赖即可。以下是以宝塔面板为例的完整部署流程，其他一键环境大同小异。

设置网站根目录指向 Laravel 的 public 文件夹

Laravel 的入口文件 index.php 在 public/ 目录下，必须确保 Web 服务器（Nginx/Apache）的根目录指向这个文件夹。

• 在宝塔面板中添加站点，填写域名（如 laravel.test）
• 创建完成后，进入“网站设置” → “网站目录”
• 将“运行目录”改为 /public，并保存
• 如果使用 Nginx，可点击“配置文件”检查 root 路径是否为：/www/wwwroot/你的项目名/public

上传并安装 Laravel 项目依赖

将本地 Laravel 项目上传到服务器指定目录（如 /www/wwwroot/laravel.test），然后通过命令行安装依赖。

• 使用 FTP 或宝塔文件管理上传代码到对应目录
• 进入“终端”或使用宝塔“计划任务”执行 Shell 命令
• 运行 composer install 安装依赖（需服务器已安装 Composer）
• 复制 .env.example 为 .env：cp .env.example .env
• 生成应用密钥：php artisan key:generate

配置数据库与权限

Laravel 需要正确配置数据库连接，并确保 storage 和 bootstrap/cache 目录有写权限。

• 在宝塔数据库页面创建 MySQL 数据库，填写 .env 中的 DB_CONNECTION、DB_DATABASE、DB_USERNAME、DB_PASSWORD
• 运行迁移命令：php artisan migrate（如有数据填充可加 --seed）
• 进入“文件”管理，选中 storage 和 bootstrap/cache 文件夹，右键“权限”，改为 755 或 777
• 确保 runtime（用于日志）也有写入权限

启用伪静态（URL 重写）

Laravel 路由基于前端控制器，需开启 URL 重写以去除 index.php。

• 在宝塔“网站设置” → “配置文件”中，找到 server 模块
• 在 location / {} 块中添加或替换为以下规则：

  if (!-d $request_filename) {
      set $rule_0 1$rule_0;
  }
  if (!-f $request_filename) {
      set $rule_0 2$rule_0;
  }
  if ($rule_0 = "21") {
      rewrite ^/(.*)$ /index.php/$1 last;
  }

• 或者直接选择“Laravel”伪静态模板（宝塔自带）

基本上就这些。刷新网站，看到 Laravel 欢迎页说明部署成功。如果报错，查看 storage/logs/laravel.log 或通过 php artisan serve 测试本地运行情况。整个过程在一键 PHP 环境中非常友好，关键是路径和权限别出错。

以上就是《一键部署Laravel项目PHP环境教程》的详细内容，更多关于Laravel,宝塔面板,权限,部署,composerinstall的资料请关注golang学习网公众号！