在php:7.2-apache Docker环境中配置Apache的CustomLog指令位置以屏蔽健康检查URL日志

Hey there! I’ve worked with this exact Docker image before, so let’s get your health check URL out of those access logs. Here’s what you need to know:

Where to Modify the CustomLog Directive #

In the php:7.2-apache image, there are two primary places you can adjust log settings:

• Site-specific config: /etc/apache2/sites-available/000-default.conf (this is the default virtual host config, where most per-site log rules live and is usually the best spot for this change)
• Global Apache config: /etc/apache2/apache2.conf (for rules that apply to all sites, though site-specific config is more flexible for application-specific tweaks)

I recommend sticking with the site-specific config to keep your log rules tied directly to your app’s virtual host.

Step-by-Step Fix #

1. Pinpoint your health check URL: Let’s assume your health check lives at /health—adjust this to match your actual endpoint.
2. Add a skip-log condition: In your virtual host config, first use SetEnvIf to flag requests to your health check URL, then update the CustomLog directive to exclude those flagged requests.

Here’s how the modified 000-default.conf would look:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html

    ErrorLog ${APACHE_LOG_DIR}/error.log
    
    # Flag requests targeting the health check URL
    SetEnvIf Request_URI "^/health$" HEALTH_CHECK
    
    # Only log requests that DON'T carry the HEALTH_CHECK flag
    CustomLog ${APACHE_LOG_DIR}/access.log combined env=!HEALTH_CHECK

    # Keep any existing config (like PHP handler settings) here
</VirtualHost>

Applying This in Docker #

You have two straightforward ways to get this custom config into your container:

Option 1: Mount the config via docker run #

Save your modified 000-default.conf locally, then run:

docker run -v $(pwd)/000-default.conf:/etc/apache2/sites-available/000-default.conf php:7.2-apache

Option 2: Build a custom Docker image #

Create a Dockerfile with these lines:

FROM php:7.2-apache

# Copy your custom config into the image
COPY 000-default.conf /etc/apache2/sites-available/000-default.conf

# Ensure the site is enabled (it's usually on by default, but this guarantees it)
RUN a2ensite 000-default.conf

# Restart Apache to apply the new config
RUN service apache2 restart

Then build and run your image as you normally would.

That’s all there is to it! Your health check requests will no longer clutter up the Apache access logs.

内容的提问来源于stack exchange，提问作者kumar