离线安装 Laravel 的核心思路是提前下载完整依赖包并规避实时网络请求:1. 下载官网发布的 Laravel 完整发行版骨架(含预置结构与 composer.json);2. 在联网环境执行 composer install --no-dev --prefer-dist 生成完整 vendor 目录并打包;3. 同步准备 PHP 运行时(≥8.2,含 mbstring、openssl 等扩展)、Composer.phar 及 Web 服务器配置模板。

离线安装 Laravel 的核心思路是:把所有依赖提前下载好,不依赖实时网络请求。你需要准备的不是“几个零散文件”,而是一套可复用、结构完整的本地资源包。重点在三类内容:
1. Laravel 项目骨架压缩包
这是起点,必须从官网获取(laravel.com → Downloads)。它包含:
- 基础目录结构(app、config、routes、resources 等)
- 关键配置文件(composer.json、.env.example)
- 入口文件(public/index.php)和 Artisan 脚本
注意:不要只下源码 ZIP,要下官方发布的完整发行版(通常标注 “Laravel X.X”),它已预置了 vendor 目录的占位结构和最小依赖声明。
2. Composer 可离线使用的依赖包缓存
这才是离线安装能否成功的关键。你需要提前在有网环境生成一份完整的依赖镜像:
- 在联网机器上,进入 Laravel 项目根目录,运行 composer install --no-dev --prefer-dist
- 执行后,vendor 目录会完整填充所有运行时依赖(如 illuminate/*、symfony/*、monolog 等)
- 将整个 vendor 文件夹打包(zip 或 tar.gz),连同 composer.json 和 composer.lock 一起保存
后续离线部署时,直接解压这个 vendor 到目标项目中,跳过在线拉包步骤。
3. 必备工具与运行环境离线包
Laravel 本身不运行,靠底层支撑。离线环境必须自带:
- PHP 运行时:对应版本(如 Laravel 11 需 PHP 8.2+),含 openssl、pdo、mbstring、xml、curl、zip 等扩展(Windows 可用 XAMPP/WAMP 离线包;Linux 可打包 .deb/.rpm 或编译好的二进制)
- Composer.phar:最新稳定版(≥2.5.0),下载地址:getcomposer.org/download/
- Web 服务器配置模板:Apache 的 .htaccess + mod_rewrite 启用说明,或 Nginx 的 server 块配置片段(含 try_files 规则),避免现场调试重写规则
这些不是 Laravel 特有,但缺一不可——没有 PHP 扩展,vendor 里的代码根本加载不了;没有正确 Web 配置,public 目录无法成为实际入口。


















