PHPackages bash/s365-content-bundle - 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. bash/s365-content-bundle ActiveSymfony-bundle bash/s365-content-bundle ======================== Symfony Bundle for S365 Content API v0.2.2(yesterday)02↑2900%MITPHPPHP >=8.2CI passing Since Apr 6Pushed todayCompare [ Source](https://github.com/amitrev/BashS365ContentBundle)[ Packagist](https://packagist.org/packages/bash/s365-content-bundle)[ RSS](/packages/bash-s365-content-bundle/feed)WikiDiscussions main Synced today READMEChangelogDependencies (28)Versions (5)Used By (0) S365 Content API Bundle ======================= [](#s365-content-api-bundle) - PHP 8.2+ - Symfony 7.4 This bundle provides a robust, DDD-oriented integration for the S365 Content API. It supports both direct API interaction and transparent request forwarding (proxying). Features -------- [](#features) - **DDD Architecture**: Separated Domain and Infrastructure layers. - **Auto-Authentication**: Handles OAuth2 Password Grant flow with internal caching. - **Request Proxying**: Easily forward requests to the S365 API via a dedicated controller. - **Traceability**: Seamless integration with Correlation IDs for end-to-end logging. - **Typed Responses**: Returns structured data objects instead of raw arrays. Installation ------------ [](#installation) ### 1. Add Environment Variables [](#1-add-environment-variables) Define the following variables in your `.env` or server environment: ``` ###> BASH S365 CONTENT BUNDLE ### S365_CONTENT_API_URL=https://example.com S365_CONTENT_API_USER=your_username S365_CONTENT_API_PASSWORD=your_password S365_CONTENT_API_CLIENT_ID=your_client_id S365_CONTENT_API_CLIENT_SECRET=your_client_secret S365_CONTENT_API_PROJECT=your_project_code S365_CONTENT_API_DISABLE_CACHE=false S365_CONTENT_API_TTL_CACHED_TOKEN=2592000 ###< BASH S365 CONTENT BUNDLE ### ``` ### 2. Manual Configuration [](#2-manual-configuration) Since this bundle does not use a public Flex recipe, you must create the configuration files manually. You can find templates in the `recipe/` directory of this bundle. #### A. Create Service Configuration (Required) [](#a-create-service-configuration-required) Copy the `recipe/config/packages/s365_content.yaml` file to your project's `config/packages/s365_content.yaml`. #### B. Create Routing Configuration (Optional) [](#b-create-routing-configuration-optional) If you want to use the proxy controller, copy the `recipe/config/routes/s365_content.yaml` file to your project's `config/routes/s365_content.yaml` and adjust the prefix if needed. ### 3. Install the Package [](#3-install-the-package) Simply run: ``` composer require bash/s365-content-bundle ``` Usage ----- [](#usage) ### Direct API Calls [](#direct-api-calls) The `ContentClient` is automatically wired and ready to use. It handles authentication and headers internally. ``` namespace App\Controller; use Bash\S365ContentBundle\Infrastructure\HttpClient\ContentClient; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\HttpFoundation\Response; class NewsController extends AbstractController { public function __construct( private readonly ContentClient $contentClient ) {} public function list(): Response { // No try-catch needed if you have a global ExceptionListener $response = $this->contentClient->request('GET', 'articles?limit=10'); return new Response( $response->getContent(), $response->getStatusCode(), ['Content-Type' => 'application/json'] ); } } ``` ### Using Correlation IDs for Traceability [](#using-correlation-ids-for-traceability) To maintain end-to-end traceability, you can pass your application's Correlation ID to the client. This ID will be sent to S365 via the `X-Correlation-ID` header. ``` // Inside your service or controller $correlationId = $request->headers->get('X-Correlation-ID'); $response = $this->contentClient->forward( method: 'GET', url: 'articles', correlationId: $correlationId // The ID is now linked to S365 logs ); ``` ### Transparent Request Forwarding (Proxy) [](#transparent-request-forwarding-proxy) Once the routes are registered, you can make requests directly to your own API domain. The bundle will authenticate and forward them to S365 automatically: **Example Flow:** 1. Client calls: `GET https://your-api.com/proxy/s365/articles?limit=10` 2. Bundle forwards to: `GET https://s365-content-api.com/articles?limit=10` (with Bearer token) 3. Client receives: Raw JSON response from S365. *Note: The proxy controller automatically strips sensitive headers like `Authorization` and `Content-Encoding` to ensure security and compatibility.* Error Handling -------------- [](#error-handling) All exceptions thrown by this bundle implement `S365ContentExceptionInterface`. This allows you to catch all S365-related errors centrally in your `ExceptionListener` or `Subscriber`. ExceptionDescription`S365AuthenticationContentException`Failed to retrieve or refresh the OAuth2 token.`S365CommunicationException`Network or transport errors (timeouts, DNS issues).`S365ContentException`The API returned a malformed response or a non-2xx status code.Example of catching errors in your application: ``` try { $data = $this->contentClient->request('GET', 'endpoint')->toArray(); } catch (S365ContentExceptionInterface $e) { // Log once, handle globally throw $e; } ``` Logging & Monitoring ------------------------ [](#logging--monitoring) This bundle logs to the `s365_content` Monolog channel. To catch these logs in your main application, add the channel to your configuration: ``` # config/packages/monolog.yaml monolog: handlers: external_api: type: rotating_file path: "%kernel.logs_dir%/external_api.log" channels: ["s365_content"] ``` Development & Testing ------------------------- [](#development--testing) ### Quality Control [](#quality-control) Run static analysis and code style fixing: ``` composer phpstan composer cs-fix ``` License ------- [](#license) MIT ### Health Score 39 — LowBetter than 85% of packages Maintenance100 Actively maintained with recent releases Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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 ~0 days Total 3 Last Release 1d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/be87fa472d40a2005e07c28858d1437d20c9093140f975bb42e82ffc0d74d1cb?d=identicon)[PureEvil](/maintainers/PureEvil) --- Top Contributors [![amitrev](https://avatars.githubusercontent.com/u/29276550?v=4)](https://github.com/amitrev "amitrev (1 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/bash-s365-content-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/bash-s365-content-bundle/health.svg)](https://phpackages.com/packages/bash-s365-content-bundle) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M643](/packages/sylius-sylius)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M151](/packages/sulu-sulu)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[simplesamlphp/simplesamlphp A PHP implementation of a SAML 2.0 service provider and identity provider. 1.1k12.4M189](/packages/simplesamlphp-simplesamlphp)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[contao/core-bundle Contao Open Source CMS 1231.6M2.3k](/packages/contao-core-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)