PHPackages paloma/shop-client - 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. [API Development](/categories/api) 4. / 5. paloma/shop-client ActiveLibrary[API Development](/categories/api) paloma/shop-client ================== Paloma Shop client library v3.5.4(11mo ago)02.8k22MITPHPPHP >=8.1CI failing Since Aug 24Pushed 11mo ago3 watchersCompare [ Source](https://github.com/paloma-middleware/shop-client-php)[ Packagist](https://packagist.org/packages/paloma/shop-client)[ RSS](/packages/paloma-shop-client/feed)WikiDiscussions v3 Synced 2d ago READMEChangelog (10)Dependencies (11)Versions (57)Used By (2) Paloma Shop PHP Client ====================== [](#paloma-shop-php-client) PHP client library for the Paloma Shop. Facilitates the access to the following APIs (see for details and code examples): - Catalog - Checkout - Customers **Note**: This is v3 of the Paloma Shop PHP Client. It is not backwards-compatible with v2 and is intended to be used together with the [Paloma Shop Bundle](https://github.com/paloma-middleware/PalomaShopBundle) for Symfony. Usage ----- [](#usage) ``` // Create Paloma client $factory = new Paloma\Shop\PalomaClientFactory($options); $client = $factory->create([ 'base_url' => 'https://demo.paloma.one/api/', 'api_key' => 'yourAPIKey', 'channel' => 'yourChannel', 'locale' => 'yourLocale', ]); // Create security service $security = new MyPalomaSecurity(); // implements \Paloma\Shop\Security\PalomaSecurityInterface // Create Paloma catalog $catalog = new \Paloma\Shop\Catalog\Catalog($client, new \Paloma\Shop\Common\PricingContextProvider($security)); // Call API, e.g. fetch catalog categories $categories = $catalog->getCategories(); // Create Symfony validator $validator = new Validator(); // implements Symfony\Component\Validator\Validator\ValidatorInterface // Create Paloma checkout $checkout = new \Paloma\Shop\Checkout\Checkout($client, $security, $validator); // Add cart item $checkout->addCartItem('100-200', 1); ``` Examples -------- [](#examples) *Hint*: Find more examples at . Get product for a category, sorted by price: ``` $page = $catalog->search(new SearchRequest(...)); ``` Get cart (e.g. to render shopping cart view): ``` $order = $checkout->getCart(); ``` Add product to cart: ``` $order = $checkout->addCartItem('12345', 1); ``` Update cart item quantity: ``` $checkout->updateCartItem('123' /* order item id */, 2 /* quantity */); ``` Remove a cart item: ``` $checkout->removeCartItem('123'); ``` Get cart items count: ``` // Number of order items $checkout->getCart()->itemsCount(); // Number of items times quantities $checkout->getCart()->unitsCount(); ``` Set order addresses: ``` $billingAddress = new Address(...); $shippingAddress = new Address(...); $checkout->setAddresses($billingAddress, $shippingAddress); ``` Initialize payment: ``` $payment = $checkout->initializePayment(new PaymentInitParameters(...)); ``` Use `$payment->getProviderParams()` to create payment URL or to render payment form. Place the order: ``` $orderPurchase = $checkout->purchase(); echo 'Purchased order ' . $orderPurchase->getOrderNumber() . '!'; ``` ### Health Score 47 — FairBetter than 94% of packages Maintenance51 Moderate activity, may be stable Popularity18 Limited adoption so far Community19 Small or concentrated contributor base Maturity86 Battle-tested with a long release history Bus Factor1 Top contributor holds 81.7% 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 ~52 days Recently: every ~144 days Total 55 Last Release 345d ago Major Versions v1.3.0 → v2.0.02017-10-18 v1.3.1 → 2.0.12017-11-02 2.20.0 → v3.0.02019-12-23 2.21.0 → v3.1.22020-04-11 v2.22.0 → v3.3.02020-11-24 PHP version history (2 changes)v3.0.0PHP >=7.2 v3.5.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/3040e7efc5d9bf912864758bec0e4e70d5acdc468d5239e960d95431d5c65b74?d=identicon)[pkraeutli](/maintainers/pkraeutli) --- Top Contributors [![pkraeutli](https://avatars.githubusercontent.com/u/886082?v=4)](https://github.com/pkraeutli "pkraeutli (125 commits)")[![avolkart](https://avatars.githubusercontent.com/u/24896337?v=4)](https://github.com/avolkart "avolkart (22 commits)")[![sandrinr](https://avatars.githubusercontent.com/u/4083653?v=4)](https://github.com/sandrinr "sandrinr (4 commits)")[![fchris82](https://avatars.githubusercontent.com/u/1598178?v=4)](https://github.com/fchris82 "fchris82 (1 commits)")[![sutter-j](https://avatars.githubusercontent.com/u/116311666?v=4)](https://github.com/sutter-j "sutter-j (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/paloma-shop-client/health.svg) ``` [![Health](https://phpackages.com/badges/paloma-shop-client/health.svg)](https://phpackages.com/packages/paloma-shop-client) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[silverstripe/framework The SilverStripe framework 7213.5M2.5k](/packages/silverstripe-framework) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)