ilab/namespacer
Composer 安装命令：
composer require ilab/namespacer
包简介
Tool for re-namespacing composer packages for use in WordPress plugins.
关键字：
README 文档
README
Using composer when building WordPress plugins sound like a good idea at first, but it won't be long until you run into trouble when other plugins are loading incompatible versions of libraries that you are using. Our plugin, MediaCloud, uses packages extensively - over 65 different libraries - many of them fairly common. I'd say over half of our support requests are due to conflicts with other plugins users have installed that are using outdated or newer versions of the same libraries we are using. The only way to really do that is to re-namespace the packages we are using and to be able to do that easily and safely.
Namespacer allows you to re-namespace any composer packages you are using by adding a namespace prefix to all of the namespaces as well as prefixing the package names too. It will then generate a folder called "lib" which you can safely include in your plugin.
Yes, I'm aware of projects out there like PHP-Scoper and Imposter and others. I've had issues with all of them, which is why I built this. Yoast and other plugins happily used PHP-Scoper, but their plugins, believe it or not, are much smaller than MediaCloud. Yoast, for example, uses 4 composer packages.
Installation
You can install this globally, but I think you'd be better off using it as the basis of a project via composer.
composer require ilab/namespacer
Usage
Once installed:
./vendor/bin/renamespace [--composer COMPOSER] [--source SOURCE] [--package PACKAGE] [--namespace NAMESPACE] [--config CONFIG] <dest>
Arguments
| Argument | Description |
|---|---|
composer |
The path (full or relative) to the composer file containing all the package dependencies you want to renamespace. You must specify this argument OR the source argument. |
source |
The path (full or relative) to a directory containing a composer file and an existing vendor directory. When using source the vendor directory must already exist (composer update must already have been run). You must specify this argument OR the composer argument. |
package |
The prefix to append to package names, for example specifying --package mcloud will turn nesbot/carbon into mcloud-nesbot/carbon. Default is mcloud. |
namespace |
The prefix to append to namespaces, for example specifying --namespace MediaCloud\Vendor will transform namespace Aws; into namespace MediaCloud\Vendor\Aws;. Default is MediaClound\Vendor. |
config |
An optional PHP configuration file for inserting filters into the namespacing process. |
<dest> |
The destination directory. Namespacer will create a directory named lib inside that directory, removing it first if it already exists. |
For example, you might run it:
./vendor/bin/namespacer --composer sample.composer.json --config patches.config.php --package mypackage --namespace MyNamespace\Vendor build/
In this example, we're pointing to a composer.json file containing the packages we want to re-namespace and to a
config file that contains filters that will apply more manual patches during the re-namespace process. The output
of the processing will be put into the build/ folder.
Filtering (Patching in PHP-Scoper parlance)
You can see some example configurations in vendor/ilab/namespacer/sample.config.php and
vendor/ilab/namespacer/patches.config.php that will demonstrate how to insert your own code into the namespacing
process to catch special cases.
Reporting Bugs
If you run into issues, please open a ticket and attach the composer.json you were trying to process with a clear description of the problem.
ilab/namespacer 适用场景与选型建议
ilab/namespacer 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 1.16k 次下载、GitHub Stars 达 29， 最近一次更新时间为 2020 年 08 月 25 日， 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向： 「wordpress」 「namespace」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 ilab/namespacer 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 ilab/namespacer 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
与 ilab/namespacer 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：
Simple autoloader that will autoload classes or traits with namespace prefix
MvcCore - Extension - Debug - Tracy - Panel Session - render and add into tracy debug panel $_SESSION content and \MvcCore\Session namespaces content.
Flexible storage solution for end-user data
Monolog cascade extension allows to configure loggers for a specific namespace/class (log4j style)
Simple PHP library for parsing and handling class aliases defined by USE statements.
Use a translation namespace vor mutliple translation files.
统计信息
- 总下载量： 1.16k
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 29
- 点击次数： 5
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： LGPL-3.0-or-later
- 更新时间： 2020-08-25