PHP Composer 虚拟依赖包 - 实现按需载入钉钉对应功能模块的 php sdk

种族平等

难得钉钉官方提供了完整的 api sdk，各种语言的版本的都有，而且 api 覆盖面非常完整。但是，composer 安装下来有大几十兆，这个不符合个人的品味，我想要按需加载。
于是在构思了一两次以后，今天下午开始动手实现。
首要原则，不做手工劳动，人工分包，然后提交到 packagist 仓库，那样后续会有巨大的维护工作量。
基本思路：

• 按固定规则在 package.json 中指定所需依赖的钉钉 sdk 的功能模块名称和版本名称，当然，它们在 packagist 仓库中肯定是不存在的；
  
• 然后利用 composer 包管理工具的 hook 机制，在恰当的时机比如 install 或 update 实现拦截，匹配这种命名规则的包名，动态虚构相应的自定义“仓库”完成下载动作。
  

实现以后，可以用来解决很多类似场景的问题。
比如，虚构的依赖包名是这样的：

1.   "require-dev": {
2.     "x3d/dingtalk-contact": "1.0"
3.   },

复制代码

x3d/dingtalk- 是前缀标识；contact 是钉钉的 api sdk 模块名；1.0 是这个模块的版本号。
这里涉及几个知识点：
1、钉钉sdk中的模块命名规则；
2、composer 的 hook 机制；
3、找到能从 github git 仓库中按目录检出代码的方式
4、虚构 composer 能支持的“仓库”类型
钉钉的 sdk 在 https://github.com/alibabacloud-sdk-php/dingtalk/tree/master/src 这个目录下，按功能模块+相应接口的版本号拼接的目录，目标是每次只按需下载某个模块的代码，并能在项目本地 被 composer 正常管理。

composer 的 hook 机制，在 官网 找到了简单的说明，但是具体是什么效果不清楚，整个下午花时间最多的就是在一个个的 hook 试，找感觉，看哪些能满足此次的需求。同时，要通过代码熟悉相应的知识点，文档是指望不上的。

最后确定了两种事件是可以的，pre-install-cmd、pre-update-cmd，其它细节可能要跟进使用情况进一步挖掘。
实现的代码比较简单，分两步，先分析出来 require 的虚构包列表，然后为他们添加虚构的代码仓库。

1. $devReqs = $this->composer->getPackage()->getDevRequires();
2.         foreach ($devReqs as $pkgName => $devReq) {
3.             if (substr($pkgName, 0, strlen($this->id)) != $this->id) {
4.                 continue;
5.             }
6.             $dtk_mods[$pkgName] = $devReq->getPrettyConstraint();
7.         }

复制代码

1.        $packages = [];
2.         foreach ($dtk_mods as $module => $version) {
3.             $packages[] = $this->configByModule($module, $version);
4.         }
6.         $sdkMirror = [
7.             "type" => "package",
8.             "package" => $packages,
9.         ];
11.         $repoName = $this->repoName;
12.         $this->composer->getConfig()->merge([
13.             'repositories' => [
14.                 $repoName => $sdkMirror,
15.             ],
16.         ]);
18.         $repoMgr = $this->composer->getRepositoryManager();
19.         $mirrorRepo = $repoMgr->createRepository('package', $sdkMirror, $repoName);
20.         $repoMgr->addRepository($mirrorRepo);
21.    
23.     /**
24.      * @param  string  $module 格式 x3d/dingtalk-service_group
25.      * @param  string  $version 格式 1.0
26.      * @return array
27.      */
28.     protected function configByModule(string $module, string $version)
29.     {
30.         // 下载对应的 dingtalk 结构代码，放到对应结构；
31.         $mod = substr($module, strlen($this->id) + 1);
32.         $dir = "{$mod}_" . str_replace('.', '_', $version);
33.         $package = [
34.             "name"=> $module,
35.             "version" => $version,
36.             "source" => [
37.                 "url" => $this->mirrorUrl,
38.                 "type" => "svn",
39.                 "reference" => "trunk/src/$dir/"
40.             ],
41.             // "target-dir" => "src/",
42.             "autoload" => [
43.                 "psr-4" => [
44.                     $this->nsPrefix . ucfirst($dir) . '\\' => "src/"
45.                 ]
46.             ]
47.         ];
49.         return $package;
50.     }

复制代码

由于国内 Gitee 的努力，很早就支持 svn 协议的兼容方案，而我们这种古早程序员从 cvs 和 svn 时代过来的，自然就联想到 转成 svn 就可以满足需求；因此，在Gitee 上建立一个 镜像仓库就，启用 svn 即可。

1. 出现以下下面提示。其中第一个认证领域是用户的密码，这个可以留空。而用户名是用户在 Gitee 登陆时使用邮箱地址。密码则是用户登陆 Gitee 所使用的密码。
3. 一般而言，svn 会加密缓存用户的用户名密码，所以，对仓库的操作只需要第一次输入用户邮箱和密码。

复制代码

然后是看 composer 如何支持这种非标准的没有 package.json composer 协议配置文件的仓库，所幸，确实是支持的。
它支持一种 type 为 package 的仓库形式，里面指定协议为 svn 就可以进一步指定代码目录，这正是我们需要的。

1. {
2.     "repositories": [
3.         {
4.             "type": "package",
5.             "package": {
6.                 "name": "smarty/smarty",
7.                 "version": "3.1.7",
8.                 "dist": {
9.                     "url": "https://www.smarty.net/files/Smarty-3.1.7.zip",
10.                     "type": "zip"
11.                 },
12.                 "source": {
13.                     "url": "http://smarty-php.googlecode.com/svn/",
14.                     "type": "svn",
15.                     "reference": "tags/Smarty_3_1_7/distribution/"
16.                 },
17.                 "autoload": {
18.                     "classmap": ["libs/"]
19.                 }
20.             }
21.         }
22.     ],
23.     "require": {
24.         "smarty/smarty": "3.1.*"
25.     }
26. }

复制代码

最后，在实操触发 svn 检出时，发现 svn 会报错，

1. could not be downloaded, Your configuration does not allow connections to svn://gitee.com/web3d/dingtalk-sdk-php/trunk/src/contact_1_0/.
3. See (https://getcomposer.org/doc/06-config.md#secure-svn-domains) for details.

复制代码

乖乖的去这个页面上去找，果然有答案。

Defaults to [].
Lists domains which should be trusted/marked as using a secure Subversion/SVN transport.
By default svn:// protocol is seen as insecure and will throw, but you can set this config option to ["example.org"] to allow using svn URLs on that hostname.
This is a better/safer alternative to disabling secure-http altogether.

在 package.json 中加一条规则：

1.   "config": {
2.     "secure-svn-domains": ["gitee.com"]
3.   },

复制代码

再试，就可以了。

来源:https://www.cnblogs.com/x3d/p/php-composer-srcipts-repos-custom-for-dingtalk-php-sdk.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！