ServeCommand does not passthrough LD_LIBRARY_PATH to PHP process

[tinyoverflow]

Laravel Version

12.5.0

PHP Version

8.3.17

Database Driver & Version

No response

Description

The ServeCommand ("php artisan serve") filters the environment variables passed through to the underlying PHP server process. In some environments (eg. corporate networks), where applications and packages are heavily audited/managed and may not use packages from the OS repositories, it might be necessary to tell the Dynamic Linker from where it has to load the libraries, hence settings the LD_LIBRARY_PATH variable. Unfortunately, this variable is excluded from passing through.

https://github.com/laravel/framework/blob/12.x/src/Illuminate/Foundation/Console/ServeCommand.php#L79-L93

I'd like to request to include this variable into the list of allowed variables. This was a pretty tough one to find out, as it properly works everywhere else.

Steps To Reproduce

1. Set the LD_LIBRARY_PATH variable on your system / shell session.
2. Run php artisan serve.
3. The underlying PHP server does not know about this variable and therefore cannot load libraries from the given LD_LIBRARY_PATH. This can be checked by reading the environment variables eg. in a controller.

[rodrigopedra]

The Illuminate\Foundation\Console\ServeCommand::$passthroughVariables is a public static property.

As such, you can customize that property's value for your particular use-case on a service provider's register method.

For example:

<?php

namespace App\Providers;

use Illuminate\Foundation\Console\ServeCommand;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     */
    public function register(): void
    {
        ServeCommand::$passthroughVariables = [
            ...ServeCommand::$passthroughVariables,
            'LD_LIBRARY_PATH',
        ];
    }

    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        //
    }
}

[rodrigopedra]

Actually on a new Laravel 12 project, without any modifications other than the route/web.php file below, and running the serve command as follows:

$ env LD_LIBRARY_PATH=/usr/lib php artisan serve

With this ./routes/web.php:

<?php

use Illuminate\Support\Facades\Route;

Route::get('/', fn () => env('LD_LIBRARY_PATH'));

Yields the output below, as expected.

/usr/lib

Also doing this:

$ export LD_LIBRARY_PATH=/usr/lib 
$ php artisan serve

Yields the same result.

So, I cannot reproduce the issue with the instructions provided.

For reference, this is my OS:

$ lsb_release -a
LSB Version:    n/a
Distributor ID: openSUSE
Description:    openSUSE Tumbleweed
Release:        20250402
Codename:       n/a

[tinyoverflow]

Ah, thank you. I somehow didn't realize that this variable was public.

---

I'll test this again later and provide some feedback.