typisttech / imposter-plugin
Composer plugin that wraps all composer vendor packages inside your own namespace. Intended for WordPress plugins.
Fund package maintenance!
typist.tech/donation
Installs: 198 749
Dependents: 2
Suggesters: 8
Security: 0
Stars: 146
Watchers: 11
Forks: 11
Open Issues: 8
Type:composer-plugin
Requires
- php: ^7.3 || ^8.0
- composer-plugin-api: ^1.1 || ^2.0
- typisttech/imposter: ^0.6.1
Requires (Dev)
- codeception/codeception: ^4.1
- codeception/module-asserts: ^1.3
- codeception/module-cli: ^1.1
- codeception/module-filesystem: ^1.0
- composer/composer: ^1.10.19 || ^2.0
- squizlabs/php_codesniffer: ^3.5
- typisttech/codeception-composer-project-module: ^0.1.1
- dev-master / 0.6.x-dev
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.0
- 0.4.0
- 0.3.1
- 0.3.0
- 0.2.6
- 0.2.5
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.0
- dev-dependabot/composer/composer/composer-2.6.5
- dev-dependabot/composer/guzzlehttp/psr7-1.9.1
- dev-dependabot/composer/squizlabs/php_codesniffer-3.7.2
- dev-dependabot/composer/codeception/codeception-4.2.2
- dev-dependabot/composer/composer/composer-2.2.9
This package is auto-updated.
Last update: 2024-10-06 18:12:01 UTC
README
Imposter Plugin
Composer plugin that wraps all composer vendor packages inside your own namespace. Intended for WordPress plugins.
Built with ♥ by Typist Tech
Imposter Plugin is an open source project and completely free to use.
However, the amount of effort needed to maintain and develop new features is not sustainable without proper financial backing. If you have the capability, please consider donating using the links below:
Wrapping all composer vendor packages inside your own namespace. Intended for WordPress plugins. Imposter Plugin is a composer plugin wrapper for Imposter.
Why?
Because of the lack of dependency management in WordPress, if two plugins bundled conflicting versions of the same package, hard-to-reproduce bugs arise. Monkey patching composer vendor packages, wrapping them inside your own namespace is a less-than-ideal solution to avoid such conflicts.
See:
- A Narrative of Using Composer in a WordPress Plugin
- A Warning About Using Composer With WordPress
- Plugin Dependencies (Yet Another Plugin Dependencies Ticket)
Install
Installation should be done via composer, details of how to install composer can be found at https://getcomposer.org/.
First, add Imposter configuration in your composer.json
"extra": { "imposter": { "namespace": "My\\App\\Vendor", "excludes": [ "dummy/dummy-excluded" ] } }
Then, install via composer cli
composer require typisttech/imposter-plugin
See: Imposter readme for details.
Typist Tech is ready to build your next awesome WordPress site. Hire us!
Usage
Sit Back and Relax
Once installed, this plugin hooks into composer install
, composer update
and composer dump-autoload
, automatically run imposter for you.
Besides, imposter plugin autoloads all modified files as classmap.
When those events triggered, this plugin:
- looks for
/path/to/project/root/composer.json
- finds out vendor-dir
- finds out all required packages, including those required by dependencies
- finds out all autoload paths for all required packages
- prefixes all namespaces with the imposter-plugin namespace defined in your
composer.json
Learn more on imposter's readme.
Known Issues
Help wanted. Pull requests are welcomed.
- Imposter run twice when
composer install
andcomposer update
- Traits are not transformed
- Virtual packages are not supported
Frequently Asked Questions
What can I find more information?
Learn more on imposter's readme for more details.
How about not hooking into composer commands?
Use imposter directly.
How to distrube impostified plugins?
- Switch to the lowest PHP version you support
- Install dependencies
$ composer install --no-dev --classmap-authoritative --prefer-dist
- Clean up the source code, e.g: remove test files
- Zip the source code. Tips: Use
$ composer archive
- Send the zip to others / Commit to wp.org SVN. Tips:
How to install impostified plugins via composer?
Impostified plugins are meant to be commited to wp.org svn.
Using imposter means you forgo the ability to install the plugins with composer directly via packagist.org or VCS (even with type: wordpress-plugin
in composer.json
).
To composer require
impostified plugins, use wpackagist.org.
The whole imposter situation is horrible. What can we do about it?
Until WordPress core comes up with a solution on dependency managment, keep clam and carry on.
In the meantime, checkout these tools to make WordPress suck less modernizing WordPress development:
- bring OOP into WordPress
- leveraging development practices from other languages and ecosystems, and applying them to WordPress
Do you have real life examples that use this composer plugin?
Here you go:
Add your own here
Which composer versions are supported?
Both v1 and v2.
Will you add support for older PHP versions?
Never! This plugin will only work on actively supported PHP versions.
Don't use it on end of life or security fixes only PHP versions.
It looks awesome. Where can I find some more goodies like this
- Articles on Typist Tech's blog
- Tang Rufus' WordPress plugins on wp.org
- More projects on Typist Tech's GitHub profile
- Stay tuned on Typist Tech's newsletter
- Follow Tang Rufus' Twitter account
- Hire Tang Rufus to build your next awesome site
Where can I give 5-star reviews?
Thanks! Glad you like it. It's important to let me knows somebody is using this project. Please consider:
- tweet something good with mentioning @TangRufus
- ★ star the Github repo
- 👀 watch the Github repo
- write tutorials and blog posts
- hire Typist Tech
Testing
composer test
composer style:check
Alternatives
Here is a list of alternatives that I found. However, none of these satisfied my requirements.
If you know other similar projects, feel free to edit this section!
-
Mozart by Coen Jacobs
- Works with PSR0 and PSR4
- Dependency packages store in a different directory
-
- Prefixes all PHP namespaces in a file/directory to isolate the code bundled in PHARs
Feedback
Please provide feedback! We want to make this project as useful as possible. Please submit an issue and point out what you do and don't like, or fork the project and send pull requests. No issue is too small.
Security Vulnerabilities
If you discover a security vulnerability within this project, please email us at imposter-plugin@typist.tech. All security vulnerabilities will be promptly addressed.
Credits
Imposter Plugin is a Typist Tech project and maintained by Tang Rufus, freelance developer for hire.
Full list of contributors can be found here.
License
Imposter Plugin is released under the MIT License.