enflow/component-laravel

Laravel package for Enflow's clients

dev-master 2024-04-17 07:38 UTC

Requires

• php: ^8.2
• doctrine/dbal: ^2.5|^3.1.4|^4.0
• enflow/error-templates: ^2.0
• itsgoingd/clockwork: ^4.0|^5.0
• laravel/framework: ^10.0|^11.0
• nunomaduro/collision: ^7.0|^8.0|^9.0
• php81_bc/strftime: ^0.7.4
• spatie/laravel-blink: ^1.0
• spatie/once: ^2.0|^3.0

MIT

• Michel Bardelmeijer

README

The component-laravel package provides a sane-default configuration for Enflow based applications. The LaravelServiceProvider registers some classes, middleware, and enables Skyline cluster support.

Installation

You can install the package via composer:

composer require enflow/component-laravel

Configuration

This package registers automatically trough Laravel's autoloading.

Exception handling

To include this ExceptionHandler to enable prettier error handling, extend the \Enflow\Component\Laravel\AbstractExceptionHandler from app/Exceptions/Handler.php file like this:

<?php

namespace App\Exceptions;

use Enflow\Component\Laravel\AbstractExceptionHandler;

class Handler extends AbstractExceptionHandler
{
    protected $dontReport = [];

    protected $dontFlash = [
        'password',
        'password_confirmation',
    ];
}

To enable Bugsnag:

1. Add a new Laravel project to your Bugsnag account and enable Slack notitifications to #failure
2. Add Bugsnag to your services.php file:

    'bugsnag' => [
        'api_key' => env('BUGSNAG_API_KEY'),
    ],

1. Add the BUGSNAG_API_KEY to your .env file

Commands

db:sync

db:sync enabled you to mysqldump a production database to your local machine and import it automatically.

Performance

To improve import time of db:sync script (tested with a 2GB database) takes ~60 min, just to import.

1. Ensure you are running MySQL 8.0 or higher on your Linux machine directly (legacy systems that connect from WSL to Windows based MySQL are much slower).
2. Change configuration settings to improve buffer sizes to allow faster importing.

sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf

Add the following after the [mysqld] block:

innodb_buffer_pool_size=4G
innodb_log_buffer_size=256M
innodb_log_file_size=1G
innodb_write_io_threads=16
innodb_flush_log_at_trx_commit=0
max_allowed_packet=1024M
read_buffer_size=2M

Restart MySQL to let these variables take effect: sudo service mysql restart

Ensure the variables are applied by checking it directly via mysql: SHOW VARIABLES LIKE "innodb_buffer_pool_size";

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Michel Bardelmeijer
• All Contributors

About Enflow

Enflow is a digital creative agency based in Alphen aan den Rijn, Netherlands. We specialize in developing web applications, mobile applications and websites. You can find more info on our website.