Need help with Laraload?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

139 Stars 9 Forks MIT License 45 Commits 7 Opened issues


Effortlessly create a PHP 7.4 Preload script for your Laravel project.

Services available


Need anything else?

Contributors list

# 67,925
41 commits
# 93,602
1 commit

Goh Rhy Yan - Unsplash #y8CtjK0ej6A

Latest Version on Packagist License Coverage Status


Effortlessly create a PHP 7.4 Preload script for your Laravel project.


  • Laravel 6 or Laravel 7
  • PHP 8, PHP 7.4.3 or later
  • ext-opcache

The Opcache extension is not enforced by the package. Just be sure to enable it in your project's PHP main process.


Call composer and you're done.

composer require darkghosthunter/laraload

What is Preloading? What does this?

Preloading is a new feature for PHP 8, PHP 7.4 and Opcache. It "compiles" a list of files into memory, thus making the application code fast without warming up. For that to work, it needs to read a PHP script that uploads the files, at startup.

This package wraps the Preloader package that generates a preload file. Once it's generated, you can point the generated list into your

opcache.preload = 'www/app/storage/preload.php';


By default, this package constantly recreates your preload script each 500 requests in

. That's it. But you want the details, don't you?
  1. A global terminable middleware checks for non-error response.
  2. Then it calls a custom Condition class.
  3. If the Condition evaluates to
    , the script is generated.
  4. A
    is called with the generation status.


Some people may not be happy with the "default" behaviour. Luckily, you can configure your own way to generate the script.

First publish the configuration file:

php artisan vendor:publish --provider="DarkGhostHunter\Laraload\LaraloadServiceProvider"

Let's check config array:

    'output' =>  storage_path('preload.php'),
    'memory' => 32,
    'use_require' => false,
    'autoload' => base_path('vendor/autoload.php'),
    'ignore-not-found' => true,


 'App\[email protected]',

This package comes with a simple condition class that returns

every 500 requests, which triggers the script generation.

You can define your own condition class to generate the Preload script. This will be called after the request is handled to the browser, and it will be resolved by the Service Container.

The condition is called the same way as a Controller action: as an invokable class or using [email protected] notation.



By default, the script is saved in your storage path, but you can change the filename and path to save it as long PHP has permissions to write on it.

Memory Limit


For most applications, 32MB is fine as a preload limit, but you may fine-tune it for your project specifically.


    'autoload' => base_path('vendor/autoload.php'),

Opcache allows to preload files using


From version 2.0, Laraload now uses

for better manageability on the files preloaded. Some unresolved links may output warnings, but nothing critical.


will execute all files, resolving all the links (parent classes, traits, interfaces, etc.) before compiling it, and may output heavy errors on files that shouldn't be executed. Depending on your application, you may want to use one over the other.

If you plan use

, ensure you have set the correct path to the Composer Autoloader, since it will be used to resolve classes, among other files.

Ignore not found files


Version 2.1.0 and onward ignores non-existent files by default. This may work for files created by Laravel at runtime and actively cached by Opcache, but that on deployment are absent, like real-time facades.

You can disable this for any reason, but is recommended leaving it alone unless you know what you're doing (and why).

Include & Exclude directories

For better manageability, you can now append or exclude files from directories using the Symfony Finder, which is included in this package, to retrieve a list of files inside of them with better filtering options.

To do so, add an

of directories, or register a callback receiving a Symfony Finder instance to further filter which files you want to append or exclude. You can do this in your App Service Provider by using the
facade (or injecting Laraload).
use Symfony\Component\Finder\Finder;
use Illuminate\Support\ServiceProvider;
use DarkGhostHunter\Laraload\Facades\Laraload;

class AppServiceProvider extends ServiceProvider { // ...

public function boot()
    Laraload::append(function (Finder $find) {

    Laraload::exclude(function (Finder $find) {



  • The package returns errors when I used it!

Check you're using latest PHP 7.4 version (critical), and Opcache is enabled. Also, check your storage directory is writable.

As a safe-bet, you can use the safe preloader script in

and debug the error.

If you're sure this is an error by the package, open an issue with full details and stack trace. If it's a problem on the Preloader itself, issue it there.

  • Why I can't use something like
    php artisan laraload:generate
    instead? Like a Listener or Scheduler?

Opcache is not enabled when using PHP CLI. You must let the live application generate the list automatically on demand.

  • Does this excludes the package itself from the list?

It does not: since the underlying Preloader package may be not heavily requested, it doesn't matter if its excluded or not. The files in Laraload are also not excluded from the list, since these are needed to trigger the Preloader itself without hindering performance.

  • I activated Laraload but my application still doesn't feel fast. What's wrong?

Laraload creates a preloading script, but doesn't load the script into Opcache. Once the script is generated, you must include it in your

- currently there is no other way to do it. This will take effect only at PHP process startup.

If you still feel your app is slow, remember to benchmark your app, cache your config and views, check your database queries and API calls, and queue expensive logic, among other things.

  • How the list is created?

Basically: the most hit files in descending order. Each file consumes memory, so the list is soft-cut when the files reach a given memory limit (32MB by default).

  • You said "soft-cut", why is that?

Each file is loaded using

. If the last file is a class with links outside the list, PHP will issue some warnings, which is normal and intended.
  • Can I just put all the files in my project?

You shouldn't. Including all the files of your application may have diminishing returns compared to, for example, only the most requested. You can always benchmark your app yourself to prove this is wrong for your exclusive case.

  • Can I use a Closure for my condition?

No, you must use your the default condition class or your own class, or use

[email protected]
  • Can I deactivate the middleware? Or check only XXX status?

Nope. If you are looking for total control, use directly the Preloader package.

  • Does the middleware works on unit testing?

Nope. The middleware is not registered if the application is running under Unit Testing environment.

  • How can I know when a Preload script is successfully generated?

When the Preload script is called, you will receive a

instance with the compilation status (
on success,
on failure). You can add a Listener to dispatch an email or a Slack notification.

If there is a bigger problem, your application logger will catch the exception.

  • Why now I need to use a callback to append/exclude files, instead of a simple array of files?

This new version uses Preloader 2, which offers greater flexibility to handle files inside a directory. This approach is incompatible with just issuing directly an array of files, but is more convenient in the long term. Considering that appending and excluding files mostly requires pin-point precision, it was decided to leave it as method calls for this kind of flexibility.


This package is licenced by the MIT License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.