PHP镜像源怎么换

wen PHP项目 2026-08-11 1

本文目录导读：

PHP镜像源怎么换

更换 Composer 镜像源（最常用）
彻底关闭 Composer 的 Packagist 源（避免回源）
更换 PECL 镜像源（用于安装 PHP 扩展）
针对 Linux 系统（Ubuntu/Debian）的 apt 源
验证是否切换成功

在 PHP 中更换镜像源，主要取决于你用的是哪种包管理器，最常见的是 Composer（PHP 的依赖管理器），其次是 PECL（扩展安装）。

以下是针对不同场景的详细换源教程：

更换 Composer 镜像源（最常用）

Composer 默认源是 Packagist 国外源，国内访问较慢，推荐使用阿里云或腾讯云镜像（两者都支持全量镜像，且同步频率高）。

方式 A：全局更换（推荐，对当前用户生效）

打开终端（命令行）,执行以下命令：

# 使用阿里云镜像（全面且稳定）
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
# 或者使用腾讯云镜像
# composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/

-g 代表全局配置，会写入 ~/.composer/config.json。

方式 B：仅对当前项目更换

在项目的根目录（包含 composer.json 的目录）执行：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

这会修改当前项目的 composer.json 文件。

方式 C：手动修改 config.json（如果没有命令行工具）

找到 Composer 的全局配置文件 ~/.composer/config.json（Windows 是 C:\Users\用户名\AppData\Roaming\Composer\config.json），如果没有则新建,填入：

{
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/"
        }
    }
}

彻底关闭 Composer 的 Packagist 源（避免回源）

有时即使配置了镜像，Composer 在找不到包时依然会去国外源验证，导致卡顿，可以禁用默认 Packagist 源：

composer config -g secure-http false
composer config -g disable-tls true

重要补充（针对新版本 Composer 2）： 如果你使用 Composer 2.x，上面的方法可能不太适合，因为 Composer 2 默认通过元数据加载，对镜像支持有变化，对于 Composer 2，推荐使用 阿里云 镜像的 composer 类型配置（即上面的方式 A 和 B），并确保版本在 2.x 以上。

Composer 2 如果发现镜像不生效，请检查是否在 composer.json 中存在 repositories 字段覆盖了全局配置，如果项目内指定了其他源,需要先清除项目内的源：

composer config --unset repos.packagist

然后在项目中重新设置为阿里云镜像。

更换 PECL 镜像源（用于安装 PHP 扩展）

如果你需要安装扩展（如 redis、swoole），Pecl 官方源较慢，可以使用 中科大 或清华镜像。

# 修改 pear 配置（PECL 基于 pear）
pear config-set php_dir /usr/local/lib/php
pear config-set download_dir /tmp
# 更换为清华源
pear config-set channel pecl.php.net https://mirrors.tuna.tsinghua.edu.cn/pecl/
# 或者使用中科大源
# pear config-set channel pecl.php.net https://mirrors.ustc.edu.cn/pecl/

针对 Linux 系统（Ubuntu/Debian）的 apt 源

如果你的问题是 apt install php 下载慢，那是操作系统的源问题，与 PHP 镜像无关：

# 备份
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 将里面的 http://archive.ubuntu.com 等地址替换为清华/阿里镜像地址
sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo apt update

验证是否切换成功

切换完后，可以执行 composer update 或 composer install 观察速度，如果之前很慢,现在应该会快很多。

如果你在容器环境（Docker）中构建，请记得在 Dockerfile 里加上对应的 RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 命令。