Octane is ignoring php.ini and disabling large file uploads

[ahmed-fawzy99]

Octane Version

2.9

Laravel Version

12.28

PHP Version

8.4

What server type are you using?

FrankenPHP

Server Version

Ubuntu 22.4 | Deployed with Laravel Forge

Database Driver & Version

PostgreSQL 17

Description

Every File upload I attempt larger than 2 MB on Filament fails. I don't see any errors in the logs, but I inspected the network requests from the browser and the errors are "413 | Request entity too large - nginx".

We're using Laravel Octane (FrankenPHP) on Forge (Ubuntu on DigitalOcean) and outside of this issue it's working fine. I'm also having the same issue running locally.

Steps to address the issue:

1. Confirmed the php.ini settings: I have set this php configuration on both /etc/php/8.4/fpm/php.ini and /etc/php/8.4/cli/php.ini:

upload_max_filesize = 40M
post_max_size = 40M
memory_limit = 128M

2. Checked Nginx configuration: Forge does this already, but manually checked Nginx config had client_max_body_size 40M;
3. Made sure no Laravel limit on file uploads or file size validation set on the file uploaders.
4. Tried changing from FrankenPHP to Swoole.
5. Restarted the services after each configuration update.

The issue still persists after all, but when I turned Octane off and switched to regular PHP-FPM pool and the uploads were working just fine as expected both on Forge and locally (using artisan serve).

It seems Octane is forcing a 2 MB limit since this is PHP's default, but I cannot find any other PHP configuration files other than the cli and the fpm on my server as these are the only 2 php configuration files found.

Steps To Reproduce

1. Update php.ini with proper file uploading limits: upload_max_filesize = 40M, upload_max_filesize = 40M, and memory_limit = 128M
2. Use FileUpload::make('attachment') on Filament.
3. Use the default octane configuration on config/octane.php and set OCTANE_SERVER=frankenphp in .env file
4. Run the server using php artisan octane:start --watch with .
5. Upload any file larger than 2 MB

[sy-records]

If you're using Swoole, there's a configuration option:

# config/octane.php
    'swoole' => [
        'options' => [
            'upload_max_filesize' => 5 * 1024,
        ]
    ]

[ahmed-fawzy99]

After a lot of trial and error, here’s what (kinda) worked for me:

1. Switch the Octane server
   Change from FrankenPHP to Swoole or Roadrunner.

2. Add a new filesystem config for Livewire in config/filesystems.php:

   'tmp' => [
       'driver' => 'local',
       'root' => storage_path('app/livewire-tmp'),
   ],

3. Publish Livewire config (if not already) and update the disk config in config/livewire.php:

   'temporary_file_upload' => [
       'disk' => 'tmp',
       // ... rest
   ],

4. Update Nginx config
   In the @octane block, add:

   proxy_set_header X-Forwarded-Proto https;

5. Trust proxies in bootstrap/app.php

   ->withMiddleware(function (Middleware $middleware) {
       // ... rest
       $middleware->trustProxies(at: '*');
   })

Local development note:

• If you’re working on http://localhost, this issue doesn’t happen.

• If you’re using Valet or similar service, you’ll need to:

  • Do steps 1, 2, and 3 above.
  • Add client_max_body_size {max_size}m; to your local Nginx config. On Production, Laravel Forge already does this part for you.

I still don’t fully understand why this works but I gave up chasing the root cause. This does not happen with Octane off, and nothing in the docs mention this.

I'm leaving this open because I think Octane docs should mention something about this, and probably my workaround might not be technically the correct way to address this. You'd ideally be looking at php.ini and Nginx configurations to find the root cause but this wasn't the case.

[AlliBalliBaba]

When using FrankenPHP, I recommend using your own Caddyfile. The php.ini settings in the Caddyfile will have precedence over all other ini settings. You can also customize a lot of other stuff, it's similar to an nginx config.
You can pass the location of the file via octane:frankenphp --caddyfile=/path/to/Caddyfile

{
	{$CADDY_GLOBAL_OPTIONS}

	admin {$CADDY_SERVER_ADMIN_HOST}:{$CADDY_SERVER_ADMIN_PORT}

	frankenphp {
		php_ini {
			upload_max_filesize 40M
			post_max_size 40M
			memory_limit 128M
		}
		worker {
			file "{$APP_PUBLIC_PATH}/frankenphp-worker.php"
			{$CADDY_SERVER_WORKER_DIRECTIVE}
			{$CADDY_SERVER_WATCH_DIRECTIVES}
		}
	}
}

{$CADDY_EXTRA_CONFIG}

{$CADDY_SERVER_SERVER_NAME} {
	route {
		root "{$APP_PUBLIC_PATH}"
		encode zstd br gzip

		# Mercure configuration is injected here...
		{$CADDY_SERVER_EXTRA_DIRECTIVES}

		php_server {
                        root "{$APP_PUBLIC_PATH}"
			index frankenphp-worker.php
			try_files {path} frankenphp-worker.php
			# Required for the public/storage/ directory...
			resolve_root_symlink
		}
	}
}