Download the PHP package mroca/request-log-bundle without Composer
On this page you can find all versions of the php package mroca/request-log-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package request-log-bundle
MrocaRequestLogBundle
An HTTP requests mock generator symfony bundle.
Description
This bundle allows to log HTTP requests and associated responses as json files. This generated json files can be used as API mock in order to test a front app without running the api.
How it works ?
After each request (Kernel::TERMINATE
event) containing the x-generate-response-mock
header, a json file is created
containing the request and the response.
Examples :
GET /categories
app/log/mocks/categories/GET__.json
PUT /categories/1 {"foo": "bar"}
app/log/mocks/categories/PUT__1-a5e74.json
File naming strategy
All files are created with the following convention :
uri/METHOD__segments{--sorted-query=string&others}{__<sha1_substr5(sortedJsonContent)>}{__<sha1_substr5(sortedPostParameters)>}.json
Examples :
URL | Filename |
---|---|
GET / | GET__.json |
GET /categories | categories/GET__.json |
GET /categories/1 | categories/GET__1.json |
GET /categories?search[category][]=foo | categories/GET__--search%5Bcategory%5D%5B%5D=foo.json |
GET /categories?order[foo]=asc&order[bar]=desc | categories/GET__--order%5Bbar%5D=desc&order%5Bfoo%5D=asc.json |
GET /categories?parent=/my/iri | categories/GET__--parent=%2Fmy%2Firi.json |
POST /categories PARAMS: foo1=bar1; foo2=bar2 | categories/POST____3e038.json |
POST /categories CONTENT: {"foo1":"bar1", "foo2":"bar2"} | categories/POST____3e038.json |
PUT /categories/1 CONTENT: {"foo2":"bar2", "foo1":"bar1"} | categories/POST13e038.json |
The filenames query strings can be hashed by setting the `hash_query_params` option to `true`.
For example, `categories/GET__--order[bar]=desc&order[foo]=asc.json` will be `categories/GET__--b0324.json`
The filenames query strings with non-asssocitive arrays are not indexed by default : `?foo[]=bar`.
You can use the indexed format by setting the `use_indexed_associative_array` option to `true` : `?foo[0]=bar`.
See the ResponseLoggerTest file for more examples.
Installation
You can use Composer to install the bundle to your project as a dev dependency :
Then, enable the bundle by updating your app/config/AppKernel.php
file to enable the bundle:
If necessary, configure the bundle to your needs (example with default values):
If your are using the NelmioCorsBundle or another CORS protection, you must add the header in the allowed ones :
Usage
The request & response logger is not always activated. To log a request, add the x-generate-response-mock
header into your request :
Commands
Some useful commands are available to manager your mocks :
Clear all mocks
Save mocks in a target directory
Dev
Php-cs-fixer
Testing
TODO
- A Guzzle client using this files for functionnals tests
- A Protractor client using this files for AngularJS e2e tests