Composer怎么安装全局的Laravel Installer_Composer如何用global require安装Laravel项目创建器【操作】-composer-PHP中文网

安装失败主因是composer全局bin目录未加入path，需手动配置；laravel new卡住多因网络问题，建议换create-project或配国内镜像；php artisan报错常因php版本

composer怎么安装全局的laravel installer_composer如何用global require安装laravel项目创建器【操作】

用 `composer global require laravel/installer` 安装失败？先看 PATH 和 Composer 全局 bin 目录

绝大多数安装后执行 laravel 命令报 command not found，不是命令写错了，而是 Composer 的全局可执行文件目录没加进系统 PATH。

Composer 默认把全局包的二进制文件（比如 laravel）放在：~/.composer/vendor/bin（macOS / Linux）或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）。这个路径必须手动加入系统环境变量，否则 shell 根本找不到它。

Linux/macOS：在 ~/.bashrc 或 ~/.zshrc 末尾加一行 export PATH="$HOME/.composer/vendor/bin:$PATH"，然后 source ~/.zshrc
Windows：在「系统属性 → 高级 → 环境变量」里，把对应路径加到「用户变量」的 PATH 中，重启终端生效
验证是否成功：运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认路径已包含；再执行 which laravel 或 where laravel 看是否返回可执行文件位置

`laravel new` 创建项目时卡住或报错？检查网络和 Composer 镜像源

laravel new myapp 实际是下载预构建的 Laravel 应用骨架（含完整 vendor），不是单纯 create-project。它依赖 GitHub 的 zip 包直链，国内访问常超时或被重定向失败。

如果你看到错误如 file_get_contents(): SSL operation failed、cURL error 7: Failed to connect，或者卡在 Downloading... 超过 2 分钟，大概率是网络问题。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

临时解决：改用 composer create-project laravel/laravel myapp，它走 Composer 包仓库，更稳定（但会慢一点，因为要装依赖）
长期建议：配置国内镜像源，运行 composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意该镜像已停用，推荐用 https://mirrors.aliyun.com/composer/ 或 https://packagist.org + 代理）
如果用了代理，确保 HTTP_PROXY/HTTPS_PROXY 环境变量已设，且 Composer 支持代理（v2.2+ 默认支持）

为什么 `laravel` 命令能直接调用，但 `php artisan` 报错？确认 PHP 版本和扩展

全局安装的 laravel 命令只是个“脚手架”，真正创建项目后，php artisan 才是 Laravel 运行核心。常见报错如 Class 'PDO' not found、mbstring extension is required，说明 PHP 运行环境不满足 Laravel 最低要求（PHP ≥ 8.1，需启用 pdo、mbstring、tokenizer、xml、curl 等扩展）。

检查当前 CLI 使用的 PHP：运行 which php 和 php -v，确认版本 ≥ 8.1
列出已启用扩展：php -m | grep -E "pdo|mbstring|tokenizer|xml|curl"，缺哪个就去 php.ini 解开对应 extension=xxx 行注释
特别注意：Mac 用户用 Homebrew 安装的 PHP，可能有多个版本共存，php -v 和 which php 不一致时，优先以 which php 输出为准

升级或卸载全局 Laravel Installer？别用 `composer update` 直接怼

全局包升级不像项目内依赖那么“安全”。composer global update 会升级所有全局包，可能意外破坏其他工具（比如 phpunit、larastan）的兼容性。

更稳妥的做法是明确指定更新目标，或彻底重装：

只升级 Laravel Installer：composer global require laravel/installer:^4.5（替换为最新稳定版号）
想干净重装：先 composer global remove laravel/installer，再 composer global require laravel/installer
查看当前安装版本：laravel --version，或 composer global show laravel/installer
注意：Laravel Installer v4 要求 Composer v2.2+，旧版 Composer 会静默降级到 v3，导致某些新功能不可用（如自动选择 PHP 版本）

全局 bin 目录权限、PHP 扩展缺失、网络代理和 Composer 镜像——这四点覆盖了 90% 的安装失败场景。其他报错基本是它们的组合表现，逐个排除比查新错误信息更有效。