搭建个人composer镜像源-云静博客

以下是搭建个人 Composer 镜像源 `https://mirrors.iyunj.cn/composer` 的详细步骤：

## 1. 环境准备
#### 服务器系统
建议使用 Linux 发行版，如 CentOS 7 或 Ubuntu 20.04。确保服务器已联网，并且具备基本的开发环境，包括 `curl`、`git` 等工具。

#### 安装必要软件
- **PHP**：Composer 是基于 PHP 开发的，需要安装 PHP 及相关扩展。以 CentOS 7 为例：
```bash
sudo yum install -y php-cli php-mbstring php-openssl php-json php-curl
```
- **Nginx**：作为 Web 服务器，用于提供镜像源的访问服务。
```bash
sudo yum install -y nginx
```
- **Composer**：用于安装 Satis 工具。可以按照前面介绍的方法在 CentOS 上安装 Composer。

## 2. 安装 Satis
Satis 是一个用于创建 Composer 镜像源的工具，通过 Composer 全局安装：
```bash
composer global require composer/satis --prefer-dist
```

### 如果satis命令不能直接使用（可选）

**查看 Composer 全局配置里 bin-dir 的路径:**

```bash
[root@iZ2vcg7ttfxd3rrs9vihurZ data]# composer global config bin-dir
Changed current directory to /root/.config/composer
vendor/bin
```

**编辑 ~/.bashrc 文件:**
```bash
vi ~/.bashrc
```

**添加 PATH 配置**

在文件末尾添加如下内容：
```bash
export PATH=$PATH:/root/.config/composer/vendor/bin
```

**保存并退出文件**

在 vim 编辑器中，按下 Esc 键，然后输入 :wq 并回车，即可保存并退出文件。

**使配置立即生效**

执行以下命令让修改后的 ~/.bashrc 文件立即生效：
```bash
source ~/.bashrc
```

**验证配置是否生效**

再次执行 satis --version 命令，若能正常显示 Satis 的版本信息，就说明 /root/.config/composer/vendor/bin 目录已经成功添加到 PATH 环境变量中，之后你就可以在任何新的终端会话中直接使用 satis 命令了

## 3. 配置 Satis
#### 创建 Satis 配置目录和文件
创建一个目录用于存放 Satis 配置文件，例如 `/www/wwwroot/satis`，并在该目录下创建 `satis.json` 文件：
```bash
mkdir -p /www/wwwroot/satis
cd /www/wwwroot/satis
touch satis.json
```

#### 编辑 `satis.json` 文件
```json
{
    "name": "iyunj-composer-mirror",
    "homepage": "https://mirrors.iyunj.cn/composer",
    "repositories": [
        {
            "type": "vcs",
            "url": "https://gitee.com/worklz/yunj-admin-tp6.git"
        },
        {
            "type": "vcs",
            "url": "https://gitee.com/worklz/yunj-admincore-tp6.git"
        },
        {
            "type": "vcs",
            "url": "https://gitee.com/worklz/yunj-library.git"
        }
    ],
    "require": {
        "yunj/admin-tp6": "*",
        "yunj/admincore-tp6": "*",
        "yunj/library": "*"
    },
    "output-dir": "./web",
    "archive": {
        "directory": "dist",
        "format": "tar",
        "skip-dev": true
    }
}
```
- `name`：镜像源的名称。
- `homepage`：镜像源的访问地址。
- `repositories`：定义要包含的仓库，可以是 Packagist 官方仓库或其他 VCS 仓库。
- `require`：指定要包含的包及其版本范围。
- `output-dir`：Satis 生成的文件输出目录。
- `archive`：配置包的归档信息。

## 4. 生成镜像源文件
在 `/www/wwwroot/satis` 目录下执行以下命令生成镜像源文件：
```bash
satis build satis.json web
```
该命令会根据 `satis.json` 配置文件生成镜像源所需的文件，并将其输出到 `web` 目录中。

如果出现镜像源问题，则更换镜像源再次进行尝试：
```bash
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
```

## 5. 获取 SSL 证书（可选）
由于要使用 HTTPS，需要获取有效的 SSL 证书。可以使用 Let's Encrypt 提供的免费证书，通过 Certbot 工具进行获取和管理。

#### 安装 Certbot
```bash
sudo yum install -y certbot python3-certbot-nginx
```

#### 获取证书
```bash
sudo certbot --nginx -d mirrors.iyunj.cn
```
按照提示完成证书的获取过程，Certbot 会自动配置 Nginx 以使用 SSL 证书。

## 6. 配置 Nginx
创建一个新的 Nginx 虚拟主机配置文件 `/etc/nginx/conf.d/mirrors.iyunj.cn.conf`：
```nginx
server {
    listen 80;
    server_name mirrors.iyunj.cn;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name mirrors.iyunj.cn;

root /www/wwwroot/satis/web;
    index index.html index.htm;

ssl_certificate /etc/letsencrypt/live/mirrors.iyunj.cn/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mirrors.iyunj.cn/privkey.pem;

location / {
        try_files $uri $uri/ /index.html =404;
    }
    
    location /composer {
        alias /www/wwwroot/satis/web;
        try_files $uri $uri/ /index.html =404;
    }

location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
```
- 第一个 `server` 块将 HTTP 请求重定向到 HTTPS。
- 第二个 `server` 块处理 HTTPS 请求，指定了 SSL 证书的路径和镜像源文件的根目录。

检查 Nginx 配置语法：
```bash
sudo nginx -t
```
如果语法检查通过，重启 Nginx 服务：
```bash
sudo systemctl restart nginx
```

## 7. 配置 DNS（如果已配置，请忽略）
将域名 `mirrors.iyunj.cn` 解析到服务器的 IP 地址。可以在域名注册商的管理界面进行 DNS 配置，添加一条 A 记录，将 `mirrors.iyunj.cn` 指向服务器的公网 IP 地址。

## 8. 使用个人镜像源
在项目的 `composer.json` 文件中添加个人镜像源的配置：
```json
{
    "repositories": [
        {
            "type": "composer",
            "url": "https://mirrors.iyunj.cn/composer"
        }
    ]
}
```
然后在项目目录下执行 `composer install` 或 `composer update` 命令，Composer 会优先从个人镜像源中下载包。

## 9. 更新镜像源
为了保证镜像源的包信息是最新的，可以使用 Cron 任务定时执行 `satis build` 命令。例如，每天凌晨 2 点更新镜像源：
```bash
0 2 * * * /root/.composer/vendor/bin/satis build /www/wwwroot/satis/satis.json /www/wwwroot/satis/web
```

或者进入手动执行：
```bash
satis build /www/wwwroot/satis/satis.json /www/wwwroot/satis/web
```

## 10. 查看镜像源已有扩展及版本

浏览器访问：https://mirrors.iyunj.cn/composer/

## 注意事项
- 确保服务器的防火墙允许 80 和 443 端口的流量通过。
- 定期更新 Satis 生成的镜像源文件，以保证包信息的及时性。
- 注意 SSL 证书的有效期，及时使用 Certbot 进行续期。

搭建个人composer镜像源

相关推荐

评论