Composer 中国全量镜像开源了，一块儿让 PHP 社区更繁荣

先上连接： https://github.com/zencodex/c...

ZComposer 镜像诞生于2017年3月份，至今已经运行2年多了，这不是一个多么有技术含量的东西，因此简单聊一些开发和解决问题的思路，但愿能对你有一点启发。若是你以为有些收获，请点下鼠标，在 github 上给我1个 star（支持下），谢谢。

1. 安全性，不对原有的json，zip作修改，不然会引发 hash 变化，从新计算 hash 没问题（以前第三方有这么作的），这样带来的问题是，没法对包的安全性作校验，假若有恶意黑镜像，对数据作了修改，就没法判断了。因此 ZComposer 的镜像，全部的包都是和 packagist.org 官方一致的，能够比对 hash ，没有任何修改。
2. 稳定性，由于不间断的采集数据，上传数据，中间有一个环节出现差错，就能够致使有问题，因此务必对采集完的包，经过 hash 值作完整性检查。有时候第三方的API策略，或者CDN线路均可能致使出现问题。因此作镜像最大的难点，是稳定性的保障。
3. Webysther/packagist-mirror（官方推荐的镜像开源） fork 自 hirak/packagist-crawler，但这些镜像开源都没有处理dist包，而dist包才是最大/最多的，最值得CDN处理的。ZComposer 开源是全量镜像，包含了对 dist 部分的处理。dist 包还有个 65000上限子目录数 的问题，1年的时间，包的数量都是成倍的增长。软链接的方案是我原创出来的，或许随着包的无限增长，还须要设计其余方案。

ZComposer 镜像的安装部署

推荐运行主机配置：

• [x] 内存最好不低于4G
• [x] 剩余磁盘空间不低于30G

$ apt install beanstalkd
$ cd composer-mirror
$ composer install

修改配置参数

一般根据本身部署的实际环境，修改参数。详细配置说明详见 config.default.php

cp config.default.php config.php，修改 config.php 中的以下参

/**
     * distdir 用于存储 zip 包
     */
    'distdir' => __DIR__ . '/dist/',

    /**
     * 指向 mirrorUrl 对应的 web 实际目录
     */
    'cachedir' => __DIR__ . '/cache/',

    /**
     * packagistUrl：官方采集源
     */
    'packagistUrl' => 'https://packagist.org',

    /**
     * 镜像包发布站点, packages.json 入口根域名
     */
    'mirrorUrl' => 'https://packagist.laravel-china.org',

    /**
     * .json 中 dist 分发 zip 包的CDN域名
     */
    'distUrl' => 'https://dl.laravel-china.org/',

supervisor 配置

sudo vim /etc/supervisor/supervisord.conf，添加以下配置信息：

[program:crawler]
command=php ./bin/console app:crawler
directory=/home/zencodex/composer-mirror/  ;部署代码的位置，自行替换
autostart=true
autorestart=true
redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 10MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 5      ; stdout 日志文件备份数
stdout_logfile = /tmp/composer_crawler_stdout.log

[program:composer_daemon]
command=php ./bin/console app:daemon
directory=/home/zencodex/composer-mirror/  ;部署代码的位置，自行替换
autostart=true
autorestart=true
redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 10MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 5      ; stdout 日志文件备份数
stdout_logfile = /tmp/composer_daemon_stdout.log

crontab 定时任务

# sudo crontab -e
# 根据本身环境代码的位置，替换 /home/zencodex/composer-mirror 
# getcomposer 是获取最新的 composer，上传到 CDN 云存储

0 */2 * * * /usr/bin/php /home/zencodex/composer-mirror/bin/console app:clear --expired=json
0 1 * * * /usr/bin/php /home/zencodex/composer-mirror/getcomposer.php

经常使用命令

# 执行抓取任务
$ php ./bin/console app:crawler

# 后台多进程模型同步又拍云
$ php ./bin/console app:daemon

# 清理过时垃圾文件
$ php ./bin/console app:clear --expired=json

# 扫描并校验全部json和zip文件的hash256
$ php ./bin/console app:scan

For Developers

• 没有使用数据库存储，彻底是按目录结构存储
• 每一个包的 dist/zip 文件存储的是对应 github url的下载地址，因磁盘空间有限，不在本地存储，直接推送到云端
• 清理过时文件，判断是否有更新，是否过时的依据是文件的时间戳，因此不要手动对文件作 touch，或引发时间戳变化的操做

若是使用非又拍云的其余平台，须要注意如下代码，须要自行实现

• ClientHandlerPlugin 须要 Flysystem 的对应 Adapter 有对应接口，本例中只有 zencodex/flysystem-upyun 实现了，其余第三方包，能够参照样例自行实现
• Cloud::refreshRemoteFile，做用是刷新 CDN 缓存的文件，这个每日有调用频率限制，因此只刷新 package.json 时使用
• Cloud::refreshRemoteFile，若是使用非又拍云的平台，须要替换为本身平台刷新代码。或者参照 ZenCodex\Support\Flysystem\Adapter\UpyunAdapter 封装 getClientHandler。
• Cloud::prefetchDistFile 和 refreshRemoteFile 相似，调用的是云平台特殊接口，没法统一封装在 Flysystem，因此也经过 getClientHandler 处理

注意最大子目录数的坑

代码详情见 src/Commands/PatchCommand.php

/*
|--------------------------------------------------------------------------
| linux ext4 支持的最大子目录数有上限，大约 64000 ~ 65000，目前包的数量已经超过上限
|--------------------------------------------------------------------------
|
| 有三种解决方法，前2种基本不现实。因此本身经过尝试，找到了3 (软链接不计数的方案)
|
|   1. 更换没有子文件夹数量限制的文件系统，好比 xfs 
|   2. 或者更改相关代码，从新编译 ext4 内核
|   3. 切割大的文件夹，分散不一样字母开头的文件。在主文件夹里面使用软链接，软链接并不计数
|
*/

ZComposer 镜像早期是  @Summer  提出的构想，期间也获得了  @overtrue  和LC社区小伙伴们的大力支持，开源也是 Overtrue 提的建议，一并感谢你们们的鼓励和支持。大侠们会在 2019 年 8 月 3 - 4 日，举办国内 第一届 Laravel Conf China 大会，可谓华山论剑，高手云集的盛会，赶忙经过官网报名吧：http://laravelconf.cn

文章首发于： https://learnku.com/articles/...