File: //scripts/rebuildhttpdconf
#!/usr/local/cpanel/3rdparty/bin/perl
# cpanel - bin/build_apache_conf                   Copyright 2022 cPanel, L.L.C.
#                                                           All rights reserved.
# copyright@cpanel.net                                         http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited
package BuildHttpdConf;
use strict;
use warnings;
=encoding utf-8
=head1 NAME
bin/build_apache_conf
=head1 USAGE
build_apache_conf [--preview] [--nolock]
=head1 DESCRIPTION
This script rebuilds Apache httpd’s main configuration file. Ordinarily
you shouldn’t need to run this manually because cPanel & WHM automatically
updates httpd’s configuration as needed.
Note that this does B<NOT> restart Apache httpd, but you’ll need to do that
in order for the new configuration file to take effect. To restart httpd,
run C</scripts/restartsrv_httpd>.
Options are:
=over
=item * C<--preview> - Creates a file named F<httpd-preview.conf> rather
than the standard F<httpd.conf>, which allows you to inspect the file
rather than having it be active right away.
=item * C<--nolock> - Ordinarily httpd.conf is locked while it is being
rebuilt to ensure that two processes don’t attempt the rebuild
concurrently. This flag suppresses that lock. You ordinarily should not
do this.
=back
=cut
use parent qw( Cpanel::HelpfulScript );
use Cpanel::ConfigFiles::Apache ();
use Cpanel::Server::Type        ();
use Cpanel::ApacheConf::Rebuild ();
use Cpanel::Hooks               ();
use constant _OPTIONS => (
    'preview',
    'nolock',
);
our $apache_conf;
if ( !caller ) {
    if ( Cpanel::Server::Type::is_dnsonly() ) {
        print "$0 does nothing under DNSONLY.\n";
    }
    else {
        __PACKAGE__->new(@ARGV)->run();
        print "Built $apache_conf OK\n";
    }
}
sub run {
    my ($self) = @_;
    my $apacheconf = Cpanel::ConfigFiles::Apache->new();
    $apache_conf = $apacheconf->file_conf();
    if ( $self->getopt('preview') ) {
        $apache_conf =~ s/httpd\.conf/httpd-preview.conf/;
    }
    my $no_lock = $self->getopt('nolock');
    Cpanel::Hooks::hook(
        {
            'category' => 'scripts',
            'event'    => "build_apache_conf",
            'stage'    => "pre",
        },
    );
    Cpanel::ApacheConf::Rebuild::rebuild_full_http_conf( $apache_conf, 0, $no_lock ? $Cpanel::ApacheConf::Rebuild::NO_LOCK : $Cpanel::ApacheConf::Rebuild::LOCK );
    Cpanel::Hooks::hook(
        {
            'category' => 'scripts',
            'event'    => "build_apache_conf",
            'stage'    => "post",
        },
    );
    return;
}
1;