PHPackages ezsystems/profiler-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. [Debugging & Profiling](/categories/debugging) 4. / 5. ezsystems/profiler-bundle ActiveEzplatform-bundle[Debugging & Profiling](/categories/debugging) ezsystems/profiler-bundle ========================= v0.5.0(8y ago)1142PHPPHP ~5.4 || ~7.0 Since Sep 6Pushed 8y ago19 watchersCompare [ Source](https://github.com/ezsystems/RepositoryProfilerBundle)[ Packagist](https://packagist.org/packages/ezsystems/profiler-bundle)[ RSS](/packages/ezsystems-profiler-bundle/feed)WikiDiscussions master Synced 2d ago READMEChangelog (1)Dependencies (3)Versions (2)Used By (0) Profiler Bundle =============== [](#profiler-bundle) Bundle to profile eZ Platform installations and setup scenarios to be able to continuously test to keep track of performance regressions of repository and underlying storage engines(s) This bundle contains two means of profiling your eZ Publish stack. - API Profiler The API profiler executes tests against the Public API or directly against the SPI. It is capable of executing different scenarios. - jMeter Tests The jMeter tests run tests against the HTTP frontend. Currently just a random browser is implement. This is most useful together with some profiling done in the background to detect the actual bottlenecks. API Profiler ------------ [](#api-profiler) ### Warning [](#warning) ``` Running the performance tests / profiling will chnage the contents of your database. Use with care. ``` ### Usage [](#usage) Install the bundle inside of an existing ez-platform installation:: ``` composer.phar require ezsystems/profiler-bundle dev-master ``` Enable Bundle in kernel by adding: ``` new eZ\Publish\ProfilerBundle\EzPublishProfilerBundle(), ``` Then you can run the performance tests using:: ``` php app/console profiler:run papi vendor/ezsystems/profiler-bundle/docs/profile_example.php ``` The provided file specifies the performance test you want to run. The file mentioned here is an example file provided with the bundle. You can run the tests either against the Public API (`papi`) or directly against the SPI (`spi`). ### Configuration [](#configuration) To model different scenarios then the on provided in the example file is a little more complex. #### Types [](#types) First we define multiple content types. The content type definitions are simpler then in the APIs to test, but are mapped accordingly:: ``` $articleType = new ContentType( 'article', [ 'title' => new Field\TextLine(), 'body' => new Field\XmlText( new DataProvider\XmlText() ), 'author' => new Field\Author( new DataProvider\User( 'editor' ) ), // … ], [$defaultLanguage, 'ger-DE', 'fra-FR'], // Languages of content 8 // Average number of versions ); ``` First we define the name of the type and then its fields. Each field should have a data provider assigned, which provides random test data. Optionally we can define multiple languages in which content will be created. Also optionally an average number of versions can be defined to "age" content. You can define as many types as sensible. #### Actors [](#actors) Actors actually do something with the defined types. There are currently three different actors, but you could define more: - `Actor\Create` Creates content structures. You can stack multiple `Create` actors to create deep content structures:: ``` $createTask = new Task( new Actor\Create( 1, $folderType, new Actor\Create( 12, $folderType, new Actor\Create( 50, $articleType, new Actor\Create( 5, $commentType ), $articles = new Storage\LimitedRandomized() ) ) ) ); ``` This example will create a structure of folder types, which, in the end, will contain articles, which will contain comments. The specified numbers are the average number of children which are created. You may optionally specify an object store, if you want to reference some of the created content objects in a different actor, like the next one. - `Actor\SubtreeView` This actors simulates an eZ Platform view operation of a content object by executing similar queries to the content repository:: ``` $viewTask = new Task( new Actor\SubtreeView( $articles ) ); ``` You should provide the actor with an object store so it can pick from a number of existing content objects which would be viewed by users of an application. - `Actor\Search` This actor just executes a search. Searches are specified as in the Public API or the SPI using a common `Query` object. #### Execution [](#execution) Finally we want to execute our configured scenario consisting of types and actors. For this an executor is used:: ``` $executor->run( array( new Constraint\Ratio( $createTask, 1/10 ), new Constraint\Ratio( $viewTask, 1 ), new Constraint\Ratio( $simpleSearchTask, 1/3 ), new Constraint\Ratio( $sortedSearchTask, 1/5 ), ), new Aborter\Count(200) ); ``` The executor will be provided with an array of `Constraint` objects each associated with a task. In this case `Constraint\Ratio` objects are used, which will only execute a task according to the given probability. The Aborter defines when the execution will be halted. It could also check for the amount of create content objects or just abort after a given time span. The `Count` aborter just aborts after the given number of iterations. You might, like done in the example, define multiple executors which then will be executed subsequently. jMeter Tests ------------ [](#jmeter-tests) ### Usage [](#usage-1) The jMeter test can be run by just executing `ant` in the root directory. In the first run jMeter will be downloaded. In subsequent runs the already downloaded files will be used. Ant 1.8 is required to run the example. The test hits the configured host and will create files providing you with statistics about the run: - `build/result.jtl` jMeter log file for further analysis - `build/result.csv` Simple grouping of response times by URL ### Configuration [](#configuration-1) You can configure the run by creating a file `jmeter.properties.local` to overwrite the variables in the `jmeter.properties` file. You definitely want to adapt the `jmeter.server` in there to point to the website you want to put under test. All options are documented in the `jmeter.properties` file. The implemented "Random Browser" only executes `GET` requests accessing random links starting at the configured start page. It will not log in or submit any forms (searches). There are two options defining the behaviour of the random surfer: - `crawler.usertype.a.breadth` On average, how many links are clicked on the same page. Causes the user to click more links on the start page and the subsequent pages. (Default: 2) - `crawler.usertype.a.depth` On average, how deep a user will click through the website. Causes the user to follow links deeper into the website structure. (Default: 3) Another important configuration is the `jmeter.users` value. It defines how many users will access / surf the website in parallel. The default of 5 means that 5 users will simultaneously surf on the website. With the configured timings that means something between 1 Req/s and 2 Req/s. ### Health Score 25 — LowBetter than 35% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community18 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 92.6% 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 Unknown Total 1 Last Release 3223d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/235928?v=4)[Bertrand Dunogier](/maintainers/bdunogier)[@bdunogier](https://github.com/bdunogier) ![](https://avatars.githubusercontent.com/u/681611?v=4)[Ibexa Bot](/maintainers/ezrobot)[@ezrobot](https://github.com/ezrobot) ![](https://avatars.githubusercontent.com/u/130489?v=4)[Łukasz Serwatka](/maintainers/lserwatka)[@lserwatka](https://github.com/lserwatka) --- Top Contributors [![kore](https://avatars.githubusercontent.com/u/154398?v=4)](https://github.com/kore "kore (100 commits)")[![andrerom](https://avatars.githubusercontent.com/u/289757?v=4)](https://github.com/andrerom "andrerom (6 commits)")[![adamwojs](https://avatars.githubusercontent.com/u/211967?v=4)](https://github.com/adamwojs "adamwojs (2 commits)") ### Embed Badge ![Health badge](/badges/ezsystems-profiler-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/ezsystems-profiler-bundle/health.svg)](https://phpackages.com/packages/ezsystems-profiler-bundle) ``` ### Alternatives [clawrock/magento2-debug Magento 2 debug module based on Magento 1 Profiler with some extra features. 8624.4k1](/packages/clawrock-magento2-debug)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k20](/packages/fleetbase-core-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)