如何下载php-cs-fixer

PHP-CS-Fixer 下载与安装完全指南：轻松让你的 PHP 代码规范化

在 PHP 开发中，保持代码风格的一致性是提升团队协作效率和代码可读性的关键，PHP-CS-Fixer（PHP Coding Standards Fixer）正是为此而生的一款强大工具，它能自动扫描并修复你的 PHP 代码，使其符合预定义的编码规范（如 PSR-12），本文将为你详细介绍如何下载并安装 PHP-CS-Fixer，让你快速上手，告别代码风格不统一的烦恼。

重要提示： 在现代 PHP 开发中，我们通常使用 Composer（PHP 的依赖管理工具）来安装 PHP-CS-Fixer，这是官方推荐且最灵活、最强大的方式，本文将重点介绍通过 Composer 安装的方法，同时也会提及其他不常用方式作为补充。

第一步：安装 Composer

在使用 Composer 之前，你的系统必须已经安装了它，Composer 是安装 PHP-CS-Fixer 的前提。

检查是否已安装 Composer 打开你的终端（Windows 下为命令提示符或 PowerShell，macOS/Linux 下为 Terminal），输入以下命令：

composer --version

如果显示了 Composer 的版本号，说明你已经安装，可以跳过此步，如果提示“命令未找到”，则需要先安装 Composer。

下载并安装 Composer 访问 Composer 官方下载页面，根据你的操作系统选择对应的安装方式进行安装。

Windows 用户： 下载 Composer-Setup.exe 文件并双击运行，按照安装向导的提示操作即可，安装时，请确保勾选了 "Add to PATH" 选项，以便在命令行中直接使用 composer 命令。
macOS/Linux 用户： 你可以按照官网提供的命令进行安装，一个通用的方法是运行以下命令（请确保已安装 Curl）：
```
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
```
安装完成后,同样可以使用 composer --version 来验证。

第二步：使用 Composer 安装 PHP-CS-Fixer

安装好 Composer 后，我们就可以通过它来下载并安装 PHP-CS-Fixer 了，主要有两种方式：全局安装和项目级安装。

全局安装（推荐）

全局安装意味着你可以在系统的任何目录下直接使用 php-cs-fixer 命令，非常适合个人开发者或需要在多个项目中使用同一版本工具的场景。

执行安装命令 在终端中，运行以下命令：

composer global require friendsofphp/php-cs-fixer

这个命令会告诉 Composer 在你的全局配置目录（通常是 ~/.composer/ 或 %USERPROFILE%\AppData\Roaming\Composer\）下下载并安装 PHP-CS-Fixer。

配置系统环境变量（关键步骤！） 安装完成后，你需要将 Composer 的 vendor/bin 目录添加到系统的 PATH 环境变量中，这样操作系统才能找到 php-cs-fixer 这个可执行文件。

Windows 10/11:
1. 在开始菜单搜索“编辑系统环境变量”并打开它。
2. 在弹出的“系统属性”窗口中，点击“环境变量”按钮。
3. 在“系统变量”部分，找到名为 Path 的变量，选中它并点击“编辑”。
4. 点击“新建”，然后添加 Composer 的 vendor\bin 目录路径，这个路径通常是 C:\Users\你的用户名\AppData\Roaming\Composer\vendor\bin。
5. 一路点击“确定”保存所有更改。
macOS / Linux: 打开你的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），在文件末尾添加以下行（请根据你的 Composer 安装路径确认）：
```
export PATH="$HOME/.composer/vendor/bin:$PATH"
```
保存文件后,在终端中运行以下命令使配置立即生效：
```
source ~/.zshrc  # 如果使用 zsh
# 或者
source ~/.bash_profile # 如果使用 bash
```

验证安装 完成环境变量配置后，重新打开一个终端窗口，输入以下命令进行验证：

php-cs-fixer --version

如果成功显示了 PHP-CS-Fixer 的版本号，恭喜你，全局安装已经完成！

项目级安装

项目级安装会将 PHP-CS-Fixer 作为你项目的一个依赖项，存放在项目根目录的 vendor/bin 文件夹中，这种方式的好处是，可以为每个项目指定不同版本的 PHP-CS-Fixer，并且可以轻松地将这个配置共享给团队中的其他开发者。

执行安装命令 在你的项目根目录下（即 composer.json 文件所在的位置），运行以下命令：

composer require --dev friendsofphp/php-cs-fixer

--dev 参数表示这是一个开发依赖，不会在生产环境中使用。

使用 PHP-CS-Fixer 安装完成后，可执行文件位于 vendor/bin/php-cs-fixer，你需要在项目根目录下通过完整路径来调用它：

./vendor/bin/php-cs-fixer --version

为了方便使用,你可以在项目的 composer.json 文件中添加 scripts，创建一个简短的命令别名：

{
    "scripts": {
        "php-cs-fixer": "php-cs-fixer"
    }
}

这样,你就可以直接在项目目录下运行 composer php-cs-fixer --version 了。

第三步：开始使用

安装完成后,你就可以开始使用 PHP-CS-Fixer 了，最常用的命令是 fix，它会自动修复指定目录下的代码。

要修复当前目录（）及其子目录下所有 PHP 文件的代码风格，可以运行：

php-cs-fixer fix .

首次运行时,PHP-CS-Fixer 会询问你希望使用哪种配置规则集（如 PSR12），你可以选择手动创建一个 .php-cs-fixer.php 配置文件，或者让它为你生成一个。

其他下载方式（不推荐）

虽然不推荐,但了解这些方式也有助于你理解其工作原理：

直接下载 Phar 包： 访问 PHP-CS-Fixer 的 GitHub 发布页面，下载最新版本的 php-cs-fixer.phar 文件，然后通过 php php-cs-fixer.phar 命令来使用，这种方式需要你手动管理版本，且无法享受 Composer 带来的依赖管理便利。
Docker 镜像： 对于已经使用 Docker 的项目，可以直接使用官方的 Docker 镜像：
```
docker run --rm -v $(pwd):/app -w /app friendsofphp/php-cs-fixer fix .
```

通过 Composer 来下载和安装 PHP-CS-Fixer 是最标准、最可靠的方法，无论是全局安装以方便日常使用，还是项目级安装以实现团队协作一致性，Composer 都能提供完美的支持。

安装完成后,只需一个简单的命令，就能让你的 PHP 代码焕然一新，始终保持整洁、规范的姿态，现在就动手试试吧，让 PHP-CS-Fixer 成为你的得力编码助手！