PHPackages astrotomic/php-conditional-proxy - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. astrotomic/php-conditional-proxy ActiveLibrary[Utility & Helpers](/categories/utility) astrotomic/php-conditional-proxy ================================ This package provides a trait and class to allow calling methods based on a condition without breaking the method chain. 0.2.1(5y ago)30155.8k↑12.9%1[1 PRs](https://github.com/Astrotomic/php-conditional-proxy/pulls)5MITPHPPHP ^7.1 || ^8.0 Since Jun 11Pushed 1y ago3 watchersCompare [ Source](https://github.com/Astrotomic/php-conditional-proxy)[ Packagist](https://packagist.org/packages/astrotomic/php-conditional-proxy)[ Docs](https://github.com/Astrotomic/php-conditional-proxy)[ Fund](https://offset.earth/treeware)[ GitHub Sponsors](https://github.com/Gummibeer)[ RSS](/packages/astrotomic-php-conditional-proxy/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (1)Versions (5)Used By (5) PHP ConditionalProxy ==================== [](#php-conditionalproxy) [![Latest Version](https://camo.githubusercontent.com/fb3bbb23b5814f0481e17ef1fbca4ec31b43ac7e8303e20b80557e3028ae2665/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617374726f746f6d69632f7068702d636f6e646974696f6e616c2d70726f78792e7376673f6c6162656c3d52656c65617365267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/astrotomic/php-conditional-proxy)[![MIT License](https://camo.githubusercontent.com/58181c8a71f6000bb4cfb76afa8e6f07bb530324e2f2fcf5697e28d73ed837ad/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f417374726f746f6d69632f7068702d636f6e646974696f6e616c2d70726f78792e7376673f6c6162656c3d4c6963656e736526636f6c6f723d626c7565267374796c653d666f722d7468652d6261646765)](https://github.com/Astrotomic/php-conditional-proxy/blob/master/LICENSE)[![Offset Earth](https://camo.githubusercontent.com/d204555ebe1fb0ae82d10c97b4f4ffc2dfdd2ba1489f98be7f7e8708333a0466/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d677265656e3f7374796c653d666f722d7468652d6261646765)](https://plant.treeware.earth/Astrotomic/php-conditional-proxy)[![Larabelles](https://camo.githubusercontent.com/a2c8d5126ddd8c5ddc627176d1d2e0568f8399b50038e71fd7f774c3e24dbe4b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726162656c6c65732d2546302539462541362538342d6c6967687470696e6b3f7374796c653d666f722d7468652d6261646765)](https://www.larabelles.com/) [![GitHub Workflow Status](https://camo.githubusercontent.com/421c772dbfac37ef7a0a971928ba41d7d79b76d10cc9ef87584174c10442d09d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f417374726f746f6d69632f7068702d636f6e646974696f6e616c2d70726f78792f72756e2d74657374733f7374796c653d666c61742d737175617265266c6f676f436f6c6f723d7768697465266c6f676f3d676974687562266c6162656c3d5465737473)](https://github.com/Astrotomic/php-conditional-proxy/actions?query=workflow%3Arun-tests)[![StyleCI](https://camo.githubusercontent.com/bd755ec11b970daecaa2be79b582e4d9a29a29503922f396368a7a05b741c1e3/68747470733a2f2f7374796c6563692e696f2f7265706f732f3237313337353931322f736869656c64)](https://styleci.io/repos/271375912)[![Total Downloads](https://camo.githubusercontent.com/d46fa5a5f03b99d6e9d7d9476f594f3e48bade5505b06a6d1e6eb5974e937b6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617374726f746f6d69632f7068702d636f6e646974696f6e616c2d70726f78792e7376673f6c6162656c3d446f776e6c6f616473267374796c653d666c61742d737175617265)](https://packagist.org/packages/astrotomic/php-conditional-proxy) This package provides a trait and class to allow calling methods based on a condition without breaking the method chain. This is useful if you want to call a method only if the variable you insert has a value. Installation ------------ [](#installation) You can install the package via composer: ``` composer require astrotomic/php-conditional-proxy ``` Usage ----- [](#usage) The easiest will be to use the `\Astrotomic\ConditionalProxy\HasConditionalCalls` trait which adds a `when()` method. The `\Astrotomic\ConditionalProxy\ConditionalProxy` is made to work with methods returning `$this` because otherwise you can get unexpected results and wrong code-completion. ``` use Astrotomic\ConditionalProxy\HasConditionalCalls; class MyClass { use HasConditionalCalls; } ``` ### Conditional chained Method [](#conditional-chained-method) You can call the `when()` method by only passing the condition and chain the method to call if the condition is `true`. ``` // foo() bar() baz() will be called $class->foo()->when(true)->bar()->baz(); // foo() baz() will be called $class->foo()->when(false)->bar()->baz(); ``` ### Conditional Callback [](#conditional-callback) If you want you can also pass a callback as second parameter to the `when()` method. ``` // foo() bar() baz() will be called $class->foo()->when(true, fn($self) => $self->bar())->baz(); // foo() baz() will be called $class->foo()->when(false, fn($self) => $self->bar())->baz(); ``` ### Advanced Usage [](#advanced-usage) If you already have an `if()` or `when()` method and want to advance it or implement this behavior in any other method you can initialize and return the `\Astrotomic\ConditionalProxy\ConditionalProxy` yourself. ``` use Astrotomic\ConditionalProxy\ConditionalProxy; class MyClass { public function if($condition) { return new ConditionalProxy($this, $condition); } public function foo($foo) { $this->foo = $foo; return $this; } } ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/Astrotomic/.github/blob/master/CONTRIBUTING.md) for details. You could also be interested in [CODE OF CONDUCT](https://github.com/Astrotomic/.github/blob/master/CODE_OF_CONDUCT.md). ### Security [](#security) If you discover any security related issues, please check [SECURITY](https://github.com/Astrotomic/.github/blob/master/SECURITY.md) for steps to report it. Credits ------- [](#credits) - [Tom Witkowski](https://github.com/Gummibeer) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Treeware -------- [](#treeware) You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree. It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats. You can buy trees at [offset.earth/treeware](https://plant.treeware.earth/Astrotomic/php-conditional-proxy) Read more about Treeware at [treeware.earth](https://treeware.earth) ### Health Score 39 — LowBetter than 86% of packages Maintenance29 Infrequent updates — may be unmaintained Popularity42 Moderate usage in the ecosystem Community20 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 87.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~103 days Total 3 Last Release 1960d ago PHP version history (2 changes)0.1.0PHP ^7.1 0.2.1PHP ^7.1 || ^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/6187884?v=4)[Tom Herrmann](/maintainers/Gummibeer)[@Gummibeer](https://github.com/Gummibeer) --- Top Contributors [![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (54 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (5 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") --- Tags hacktoberfesttreewareproxyconditional-proxy ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/astrotomic-php-conditional-proxy/health.svg) ``` [![Health](https://phpackages.com/badges/astrotomic-php-conditional-proxy/health.svg)](https://phpackages.com/packages/astrotomic-php-conditional-proxy) ``` ### Alternatives [fideloper/proxy Set trusted proxies for Laravel 7.3k174.4M559](/packages/fideloper-proxy)[ocramius/proxy-manager A library providing utilities to generate, instantiate and generally operate with Object Proxies 5.0k82.4M230](/packages/ocramius-proxy-manager)[symfony/var-exporter Provides tools to export, instantiate, hydrate, clone and lazy-load PHP objects 2.1k378.1M441](/packages/symfony-var-exporter)[friendsofphp/proxy-manager-lts Adding support for a wider range of PHP versions to ocramius/proxy-manager 1.2k139.1M104](/packages/friendsofphp-proxy-manager-lts)[vkartaviy/retry The library for repeatable and retryable operations 29227.2k2](/packages/vkartaviy-retry) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)