README.md

HTTP User Agent for Laravel

FAQ

• Q: What problem does this package solve?
• A: In cases where it is necessary to explicitly specify the value User-Agent in outgoing requests. In other cases it is not necessary.

Installation

composer require dragon-code/laravel-http-user-agent

Basic Usage

It's all. Really 😎

When a package is installed, it will automatically specify the value of the User-Agent header in the following format (by default):

%s / %s - %s | %s

For example:

Site Name / 1.0 - https://example.com - [email protected]

where:

• Site Name - value of the APP_NAME environment parameter
• 1.0 - specific version of the application. If the version parameter is specified in the composer.json file, its value will be taken, otherwise 1.0 will be used by default.
• https://example.com - value of the APP_URL environment parameter
• [email protected] - value of the MAIL_FROM_ADDRESS environment parameter

If you want to change this value, add a new parameter APP_USER_AGENT to the .env file.

For example:

APP_USER_AGENT = "Cool Site - https://the-best.example.com"

Now, the value of the User-Agent header in all external Http requests will be specified as Cool Site - https://the-best.example.com.

Configuration

If you need direct access to the configuration file, you can publish it to your application by calling the following console command:

php artisan vendor:publish --provider="DragonCode\LaravelHttpUserAgent\ServiceProvider"

As a result of its execution, the file config/http.php will be created.

You can also disable value assignment through the environment settings:

APP_USER_AGENT_ENABLED = false

License

This package is licensed under the MIT License.