Laravel安装提示“zip扩展未启用”需先验证再启用:Windows修改php.ini取消extension=zip前的分号,Linux/macOS用包管理器安装php-zip并重启服务,最后确认PHP≥8.1及其他扩展如mbstring、openssl等已启用。

Laravel安装时提示“zip扩展未启用”,说明PHP环境缺少或未加载zip扩展——这是Laravel项目创建(尤其是通过composer create-project)的硬性依赖,因为Composer需用它解压下载的包。解决的关键不是重装PHP,而是确认并启用该扩展。
先确认zip扩展是否真的没启用
别凭感觉判断,用命令验证:
- Windows:打开命令行,运行
php -m,在输出列表里手动查找zip; - Linux/macOS:运行
php -m | grep zip; - 更可靠方式:新建一个
test.php文件,写入<?php echo class_exists('ZipArchive') ? '已启用' : '未启用'; ?>,浏览器访问或命令行执行php test.php。
Windows系统:修改php.ini启用zip
多数Windows用户的问题出在这步没做对:
- 运行
php --ini查看CLI模式实际加载的php.ini路径(注意:Apache和CLI可能用不同配置文件,composer走的是CLI); - 用记事本或编辑器打开该
php.ini,搜索extension=zip; - 如果这行前面有分号
;,删掉它(变成extension=zip); - 保存文件,重启你的Web服务器(如Apache)或确保CLI环境已刷新(可关掉终端重开);
- 再运行
php -m | grep zip或上面的测试脚本确认生效。
Linux/macOS系统:用包管理器安装并启用
不同发行版命令略有差异,但逻辑一致:
- Ubuntu/Debian:
sudo apt update && sudo apt install php-zip; - CentOS/RHEL 7/8:
sudo yum install php-zip或sudo dnf install php-zip; - macOS(Homebrew):
brew install php@8.2(根据你用的PHP版本调整),安装后通常自动启用; - 安装完务必重启服务:
sudo systemctl restart apache2(或nginx)、sudo systemctl restart php8.2-fpm(按实际PHP版本替换)。
验证通过后继续Laravel安装
扩展启用成功只是第一步,还需检查其他必需项是否就绪:
- PHP版本 ≥ 8.1(Laravel 10+要求):运行
php -v确认; - 其他关键扩展必须启用:mbstring、openssl、pdo、tokenizer、xml、ctype、json、fileinfo;
- Composer版本 ≥ 2.5(推荐最新):
composer self-update; - 再执行安装命令:
composer create-project laravel/laravel your-project --prefer-dist。


















