如何定位服务器现有Laravel项目核心目录并安装依赖本地运行

如何定位包含composer.json的项目根目录 #

Laravel的项目根目录有明确的固定结构，你在FileZilla里浏览目录时，只要看到某个目录下同时存在以下文件/文件夹，就是你要找的主目录：

• 直接包含composer.json、composer.lock、artisan、.env.example文件
• 直接包含app/、bootstrap/、config/、public/、resources/、routes/这几个一级子目录

注意不要把public/目录误判为根目录，多数服务器会把站点访问入口指向public文件夹，这个子目录里没有composer.json，无法执行composer命令。

无需下载的大体积目录 #

服务器上6G+的项目体积基本都来自可本地重新生成的内容，这些目录完全不需要下载，能帮你省90%以上的下载时间：

• vendor/：Composer安装的所有PHP依赖，本地执行composer install会完全重新生成，通常占2-4G空间
• node_modules/：NPM安装的前端依赖，本地执行npm install会完全重新生成，通常占1-3G空间
• storage/logs/：历史运行日志，无业务价值
• storage/framework/cache/、storage/framework/sessions/、storage/framework/views/：框架运行时生成的缓存、会话、编译视图文件，本地启动项目时会自动生成
• public/storage/：指向storage目录的软链接，本地执行php artisan storage:link即可重新生成

必须下载的核心内容 #

定位到正确的根目录后，只需要下载以下内容，就可以正常执行composer install并在本地运行项目：

1. 根目录下的核心配置文件：所有一级目录下的.php、.json、.js、.example后缀文件，包括composer.json、composer.lock、artisan、package.json、vite.config.js（旧版本Laravel为webpack.mix.js）、.env.example，如果根目录有.env文件也一并下载，省得本地重新配置参数
2. 核心业务目录：
   • app/：所有核心业务代码，包含控制器、模型、服务类、中间件等核心逻辑
   • bootstrap/：框架启动引导文件
   • config/：所有项目配置文件
   • database/：数据库迁移、数据种子、工厂文件
   • public/：项目入口文件，只需要下载index.php、.htaccess（Nginx环境可能没有）、favicon.ico即可，如果有需要本地调试的用户上传文件再按需下载，不用全下
   • resources/：视图模板、未编译的前端源码、多语言包
   • routes/：所有路由定义文件

本地启动参考步骤 #

核心文件下载到本地后，在项目根目录依次执行以下命令即可启动项目：

1. 安装PHP依赖：composer install
2. 复制环境配置文件：没有.env的话执行cp .env.example .env，然后修改.env里的数据库、缓存等本地配置参数
3. 生成应用加密密钥：php artisan key:generate
4. （可选）如果项目有前端代码，安装前端依赖：npm install
5. （可选）编译前端资源：npm run dev
6. 启动本地开发服务：php artisan serve，默认访问地址为http://localhost:8000

内容的提问来源于stack exchange，提问作者AAA