cpanmp - 云端在线

程序：

您的姓名

cpanm - 从 CPAN 获取、解压构建和安装模块

概要

cpanm 测试::更多 # 安装测试::更多
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # 完整分发路径
CPAM http://example.org/LDS/CGI.pm-3.20.tar.gz # 从 URL 安装
CPAM 〜/dists/MyCompany-Enterprise-1.00.tar.gz # 从本地文件安装
cpanm --interactive Task::Kensho # 交互配置
cpanm . #从本地目录安装
cpanm --installdeps 。 # 安装当前目录的所有 deps
cpanm -L extlib Plack # 将 Plack 和所有非核心 deps 安装到 extlib 中
cpanm --镜像 http://cpan.cpantesters.org/ DBI # 使用快速同步镜像
cpanm --from https://cpan.metacpan.org/ Plack # 只使用 HTTPS 镜像

指令

（论据）
命令行参数可以是模块名称、分发文件、本地文件
路径、HTTP URL 或 git 存储库 URL。 以下命令将按您的预期工作。

cpanm 板
cpanm 发布/请求.pm
cpanm 宫川/Plack-1.0000.tar.gz
cpanm /path/to/Plack-1.0000.tar.gz
CPAM http://cpan.metacpan.org/authors/id/M/MI/MIYAGAWA/Plack-0.9990.tar.gz
cpanm git://github.com/plack/Plack.git

此外，您可以使用使用“~”和“@”的符号来指定版本
给定模块。 "~" 以 CPAN::Meta::Spec 格式指定版本要求，
而“@”固定确切版本，并且是“~”== VERSION“”的快捷方式。

cpanm Plack~1.0000 # 1.0000 或更高版本
cpanm Plack~">= 1.0000, < 2.0000" # 最新的 1.xxxx
CPAM [电子邮件保护] # 具体版本。 与 Plack 相同~"== 0.9990"

包含特定版本或范围的版本查询将发送到 MetaCPAN 以
搜索以前的版本。 默认情况下，查询将搜索 BackPAN 档案，
除非您指定“--dev”选项，在这种情况下，存档版本将被过滤
出。

对于 git 存储库，您可以指定分支、标记或提交 SHA 来构建。 这
默认为“主”

cpanm git://github.com/plack/[电子邮件保护] ＃ 标签
cpanm git://github.com/plack/Plack.git@devel # 分支

-i，--安装
安装模块。 这是默认行为，这只是兼容性
使其像 cpan 或 cpanp 一样工作的选项。

--自我升级
自我升级。 它只是一个别名：

cpanm 应用程序::cpanminus

- 信息
以“AUTHOR/Dist-Name-ver.tar.gz”格式显示分发信息
标准出来。

--installdeps
安装目标发行版的依赖项，但不会自行构建。 方便的话
您想从版本控制的存储库（例如 git）尝试应用程序。

cpanm --installdeps 。

- 看
下载并解压发行版，然后用你的 shell 打开目录。
方便地查看源代码或进行手动测试。

-h，--帮助
显示帮助信息。

-V，--version
显示版本号。

配置

您可以在“PERL_CPANM_OPT”环境变量中指定默认选项。

-f，--强制
即使测试失败也强制安装模块。

-n, --notes
跳过模块的测试。 仅当您只想节省时间时才使用它
将数百个发行版安装到您已经使用的相同 perl 和架构中
测试以确保它构建良好。

默认为 false，当它在
“PERL_CPANM_OPT”中的默认选项。

--仅测试
仅运行测试，不要安装指定的模块或发行版。 方便的话
你想验证新的（甚至旧的）版本是否通过了单元测试
安装模块。

请注意，如果您使用具有以下功能的模块或发行版指定此选项
依赖项，如果您当前没有这些依赖项，则会安装它们。

-S，--须藤
安装模块时使用“sudo”切换到 root 用户。 如果你想使用这个
将模块安装到系统 perl 包含路径。

默认为 false，您可以说“--no-sudo”在设置时覆盖
“PERL_CPANM_OPT”中的默认选项。

-v，--详细
使输出变得冗长。 它还启用交互式配置。 （看
- 交互的）

-q, --安静
使输出比默认值更安静。 它只显示成功/失败
对输出的依赖。

-l，--本地库
设置要安装模块的 local::lib 兼容路径。 你不需要设置这个
如果您已经使用 local::lib 配置了 shell 环境变量，但是这
也可以用来覆盖它。

-L, --local-lib 包含
与“--local-lib”相同，但带有--self-contained set。 所有非核心依赖项都将
即使它们已经安装，也要安装。

例如，

cpanm -L extlib 普拉克

会将Plack及其所有非核心依赖项安装到目录“extlib”中，
可以从您的应用程序加载：

使用 local::lib '/path/to/extlib';

请注意，此选项确实 不是 可靠地使用由提供的 perl 安装
从 perl 中剥离标准模块的操作系统供应商，例如 RHEL、Fedora
和 CentOS， 除非 您还安装了提供所有模块的软件包
剥离。 对于这些系统，您可能需要安装“perl-core”元-
包就是这样做的。

--自包含
检查依赖项时，假设没有安装非核心模块
系统。 如果您想将应用程序依赖项捆绑在一个目录中以便您
可以分发到其他机器。

--排除供应商
搜索核心时不要包含安装在“供应商”路径下的模块
“--self-contained”标志生效时的模块。 这将恢复行为
从之前的版本 1.7023

- 镜子
指定要使用的 CPAN 镜像的基本 URL，例如
"http://cpan.cpantesters.org/"（您可以省略尾部斜杠）。您可以指定
通过重复命令行选项来创建多个镜像 URL。

您可以使用具有 CPAN 镜像结构的本地目录（由诸如
作为 OrePAN 或 Pinto）通过使用特殊的 URL 方案“file://”。 如果给定的 URL 开始
使用`/`（没有任何方案），它也被视为文件方案。

cpanm --mirror 文件:///path/to/mirror
cpanm --镜像 〜/迷你盘 # 因为shell将~扩展到/home/user

默认为“http://www.cpan.org/".

--仅镜像
下载镜像的 02packages.details.txt.gz 索引文件，而不是查询
CPAN 元数据库。 这也将有效地选择不将您的本地 perl 版本发送到
后端数据库服务器，例如 CPAN Meta DB 和 MetaCPAN。

如果您使用的是 CPAN 的本地镜像，例如 minicpan，请选择此选项
您处于离线状态，或者您自己的 CPAN 索引（又名 Darkpan）。

--来自，-M
cpanm -M https://cpan.metacpan.org/
cpanm --来自 https://cpan.metacpan.org/

使用给定的镜像 URL 及其索引作为 仅由 搜索和下载的来源
模块从。

它的工作原理类似于“--mirror”和“--mirror-only”的组合，但有一点不同：
不像“--mirror” 附加 镜像列表的 URL，“--from”（或“-M”表示
短）使用指定的 URL 作为它的 仅由 从中下载索引和模块的源。
这使得该选项始终覆盖可能已设置的默认镜像
通过全局选项，例如由“PERL_CPANM_OPT”环境变量设置的选项。

提示： 如果您使用 shell 别名命名这些选项可能会很有用，例如：

别名 minicpanm='cpanm --from 〜/迷你盘'
别名 darkpan='cpanm --from http://mycompany.example.com/DPAN'

--镜像索引
实验: 指定文件路径到“02packages.details.txt”进行模块搜索
指数。

--cpanmetadb
实验：指定用于 CPAN MetaDB 索引查找的备用 URI。

--metacpan
比 CPAN MetaDB 更喜欢 MetaCPAN API。

--cpanfile
实验: 指定 cpanfile 搜索的备用路径，当
“--installdeps”命令正在使用中。 默认为“cpanfile”。

- 迅速的
测试失败时提示，以便您可以跳过、强制安装、重试或查看
shell 看看出了什么问题。 如果依赖项之一失败，它还会提示
您想继续安装。

默认为 false，如果它在
“PERL_CPANM_OPT”中的默认选项。

--dev
实验：也搜索更新的开发人员版本。 默认为假。

--重新安装
cpanm，当在命令行中给出一个模块名称（即“cpanm Plack”）时，检查
首先本地安装的版本，如果已经安装则跳过。 这个选项
让它跳过检查，所以：

cpanm --重新安装Plack

即使您本地安装的版本是最新的，甚至更新，也会重新安装 Plack
（如果您从版本控制安装开发人员版本，则会发生这种情况
存储库）。

默认为false。

- 交互的
使配置（例如“Makefile.PL”和“Build.PL”）具有交互性，因此您可以
在需要自定义配置或任务的发行版中回答问题::
分布。

默认为 false，您可以说“--no-interactive”来覆盖它在
“PERL_CPANM_OPT”中的默认选项。

--pp, --pureperl
通过为 MakeMaker 设置“PUREPERL_ONLY=1”来首选 Pure perl 构建模块
“--pureperl-only”适用于基于 Build.PL 的发行版。 请注意，并非所有的 CPAN
模块还支持这个约定。

--with-推荐，--with-建议
实验：安装声明为“推荐”和“建议”的依赖项
分别根据 META 规范。 当这些依赖安装失败时，cpanm 继续
安装，因为它们只是推荐/建议。

启用此功能可能会对 CPAN 上的几个模块产生循环依赖，
当“推荐”添加一个模块时，该模块“推荐”返回该模块。

还有“--without-recommend”和“--without-suggests”来覆盖默认值
早先在“PERL_CPANM_OPT”中做出的决定。

两者都默认为 false。

--with-开发
实验: 在 META 文件或“cpanfile”中安装开发阶段依赖项
与“--installdeps”一起使用。 默认为假。

--with-feature, --without-feature, --with-all-features
实验: 指定要启用的功能，如果模块支持可选功能
根据 META 规范 2.0。

cpanm --with-feature=opt_csv 电子表格::读取

启用“--interactive”选项时，也可以交互式选择这些功能。

“--with-all-feature”启用所有可选功能，“--without-feature”可以
选择要禁用的功能。

--configure-timeout，--build-timeout，--test-timeout
指定等待配置、构建和测试的超时长度（以秒为单位）
过程。 当前默认值为：60 用于配置，3600 用于构建，1800 用于构建
测试。

--configure-args，--build-args，--test-args，--install-args
实验: 分别为 configure/build/test/install 命令传递参数，
对于要安装的给定模块。

cpanm DBD::mysql --configure-args="--cflags=... --libs=..."

该参数仅对作为命令行参数传递的模块启用，而不是
依赖性。

--scandeps
弃用: 扫描给定模块的依赖并以文本形式输出树
格式。 （有关更多选项，请参阅下面的“--format”）

因为这个命令实际上并没有安装任何发行版，所以它会很有用
输入：

cpanm --scandeps 催化剂::运行时

您可以确定将安装哪些模块。

此命令会考虑您已在您的系统中安装的模块
系统。 如果您想查看将针对 vanilla perl 安装哪些模块
安装时，您可能希望将其与“-L”选项结合使用。

- 格式
弃用：确定显示扫描的依赖树的格式。 可用的
选项是“树”、“json”、“yaml”和“dists”。

tree 以纯文本格式显示树。 这是默认值。

json、yaml
以 JSON 或 YAML 格式输出树。 JSON 和 YAML 模块需要
分别安装。 输出树表示为递归元组
作者：

[分布，依赖项]

并且容器是一个包含根元素的数组。 请注意，有
可能是多个根节点，因为你可以给多个模块
“--scandeps”命令。

diss "dists" 是一种特殊的输出格式，它打印分发文件名
，在 深度 第一 秩序 在依赖解析之后，例如：

GAAS/MIME-Base64-3.13.tar.gz
GAAS/URI-1.58.tar.gz
PETDANCE/HTML-Tagset-3.20.tar.gz
GAAS/HTML-Parser-3.68.tar.gz
GAAS/libwww-perl-5.837.tar.gz

这意味着您可以按此顺序安装这些发行版而无需额外
依赖关系。 与“-L”选项结合使用时，重播会很有用
安装在其他机器上。

--保存距离
指定在 CPAN 镜像中复制下载的 tarball 的可选目录路径
兼容的目录结构即 作者/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

如果发行版 tarball 不是来自 CPAN，例如来自本地文件或来自
GitHub，然后会保存在 供应商/Foo-Bar-version.tar.gz.

--uninst-阴影
卸载您正在安装的发行版的影子文件。 这个
如果您尝试从
针对 perl 5.10 或更早版本的 CPAN，或者曾经基于 XS 但切换到的模块
某些版本的纯 perl。

如果您以 root 身份运行 cpanm 并使用“INSTALL_BASE”或等效物来指定自定义
安装路径，你应该禁用这个选项，这样你就不会意外卸载
双寿命模块从核心包括路径。

如果您的 perl 版本小于 5.12，则默认为 true，您可以禁用它
带有“--no-uninst-shadows”。

注意: 从 1.3000 版本开始，默认情况下，对于比
5.12，因为 5.12 @INC 包含 site_perl 目录 before perl 核心库
路径，并且不再需要卸载阴影，删除会造成更大的伤害
核心库路径中的文件。

--卸载，-U
从库路径卸载模块。 它为给定的模块找到一个packlist，并且
删除包含在同一发行版中的所有文件。

如果启用 local::lib，它只会从 local::lib 目录中删除文件。

如果您尝试卸载“perl”目录中的模块（即核心模块），则会出现错误
被抛出。

将提示确认要删除的文件的对话框。 如果你通过“-f”选项
同样，将跳过该对话框并强制卸载。

--级联搜索
实验: 指定指定多个镜像时是否级联搜索
并且镜像没有模块或模块的版本低于
要求。 默认为假。

--跳过安装
指定是否跳过命令行中给出的模块的最新版本
已经安装。 默认为真。

注意：必须正确设置“PERL5LIB”环境变量才能使其工作
使用 local::lib 安装模块，除非您总是使用“-l”选项。

--跳过-满意
实验: 指定命令行中给出的模块（和版本）是否为
如果已经安装，则跳过。

如果你运行：

cpanm --跳过满意的 CGI DBI~1.2

如果您已经拥有 CGI（对于任何版本）或拥有 DBI，cpanm 将不会安装它们
版本高于 1.2。 它类似于“--skip-installed”，但同时
“--skip-installed”检查是否 最新 已安装 CPAN 版本，
“--skip-satisfied”检查请求的版本（或不是，这意味着任何版本）是否是
安装。

默认为false。

- 核实
使用 CHECKSUMS 验证从 PAUSE 检索的分发文件的完整性和
签名（如果找到）。 默认为假。

--report-perl-版本
是否将本地安装的 perl 版本报告给各种 web 服务器作为
用户代理的一部分。 默认为真，除非 CI 相关的环境变量，如
启用“TRAVIS”、“CI”或“AUTOMATED_TESTING”。 您可以通过使用禁用它
“--no-report-perl-version”。

--自动清理
指定 cpanm 的工作目录过期的天数。 默认为 7，
这意味着旧的工作目录将在一周内清理干净。

您可以将该值设置为 0 以使 cpan 永远不会清理这些目录。

--手册页
为可执行文件 (man1) 和库 (man3) 生成手册页。

默认为 true（生成手册页），除非“-L|--local-lib-contained”选项是
在这种情况下，它被设置为 false。 您可以使用“--no-man-pages”禁用它。

--lwp
使用 LWP 模块通过 HTTP 下载内容。 默认为 true，你可以说
"--no-lwp" 禁用使用 LWP，当你想从 CPAN 升级 LWP 时
perl 系统。

--wget
使用 GNU Wget（如果可用）来下载东西。 默认为 true，你可以说
"--no-wget" 禁用使用 Wget（早于 1.9 的 Wget 版本不支持
cpanm 使用的“--retry-connrefused”选项）。

- 卷曲
使用 cURL（如果可用）下载内容。 默认为 true，你可以说
"--no-curl" 禁用使用 cURL。

通常将“--lwp”、“--wget”和“--curl”选项设置为true（这是
默认）cpanm 尝试 LWP、Wget、cURL 和 HTTP::Tiny（按此顺序）并使用第一个
一个可用。

使用 onworks.net 服务在线使用 cpanmp