PHP/Nginx Large File Handling Configuration

This guide provides a comprehensive solution for handling large file uploads (>2GB) through PHP and Nginx APIs.

Common Issues

• Empty response with 200 status code for files >2GB
• Timeout during upload process
• Memory exhaustion
• Incomplete file transfers

Server Configuration

PHP Configuration (php.ini)

; File upload limits
post_max_size = 4000M
upload_max_filesize = 4000M
memory_limit = -1

; Timeouts
max_execution_time = 300
max_input_time = 300

; Buffer settings
output_buffering = Off
zlib.output_compression = Off

; Error reporting for debugging
error_reporting = E_ALL
display_errors = On
log_errors = On

Nginx Configuration (nginx.conf)

http {
    # Client body size
    client_max_body_size 4000M;
    
    # Timeouts
    fastcgi_read_timeout 300;
    fastcgi_send_timeout 300;
    proxy_read_timeout 300;
    
    # Buffer sizes
    client_body_buffer_size 128k;
    client_header_buffer_size 1k;
}

PHP-FPM Configuration

; Timeout settings
request_terminate_timeout = 300

; Slow log configuration
slowlog = /var/log/php-fpm/slow.log
request_slowlog_timeout = 60