diff --git a/migrations/container/20261021120100_site-type-php_disable_php_session_upload_progress.php b/migrations/container/20261021120100_site-type-php_disable_php_session_upload_progress.php index 24442ac..0718600 100644 --- a/migrations/container/20261021120100_site-type-php_disable_php_session_upload_progress.php +++ b/migrations/container/20261021120100_site-type-php_disable_php_session_upload_progress.php @@ -14,6 +14,9 @@ class DisablePhpSessionUploadProgress extends Base { const SITE_TYPE = 'php'; + /** Largest custom.ini read. */ + const MAX_SIZE = 1048576; + const SETTING_LINES = [ '; Session upload progress is off for security; set it to On only if your app needs it.', 'session.upload_progress.enabled = Off', @@ -22,7 +25,7 @@ class DisablePhpSessionUploadProgress extends Base { /** @var Site[] */ private $sites = []; - /** @var array site_url => [ 'site' => Site, 'file' => string, 'backup' => string|null ] for every custom.ini changed by up(). */ + /** @var array site_url => [ 'site' => Site, 'file' => string, 'dir' => string, 'backup' => string ] for every custom.ini changed by up(). */ private $changed = []; /** @var array site_url => php container ID seen by up(), for running sites. */ @@ -225,26 +228,25 @@ private static function global_part( string $content ) { */ private function update_site( $site ) { - $conf_dir = $site->site_fs_path . '/config/php/php/conf.d'; - $file = $conf_dir . '/custom.ini'; - $manual = "Add 'session.upload_progress.enabled = Off' to $file and run: ee site reload $site->site_url"; - - if ( is_link( $file ) || ( file_exists( $file ) && ! is_file( $file ) ) ) { - EE::warning( "Skipped disabling session.upload_progress for $site->site_url: custom.ini is not a regular file. $manual" ); - - return; - } + $file = $site->site_fs_path . '/config/php/php/conf.d/custom.ini'; + $manual = "Add 'session.upload_progress.enabled = Off' to $file and run: ee site reload $site->site_url"; - $created = ! file_exists( $file ); - if ( $created && ! is_dir( $conf_dir ) ) { - EE::warning( "Skipped disabling session.upload_progress for $site->site_url: $conf_dir is missing. $manual" ); + // Not created when missing: PHP can't create a file safely in a directory the site's php container can swap. + if ( ! file_exists( $file ) && ! is_link( $file ) ) { + EE::warning( "Skipped disabling session.upload_progress for $site->site_url: custom.ini is missing. $manual" ); return; } - $content = $created ? '' : @file_get_contents( $file ); - if ( false === $content ) { - EE::warning( "Skipped disabling session.upload_progress for $site->site_url: could not read custom.ini. $manual" ); + try { + $base = realpath( $site->site_fs_path . '/config/php' ); + if ( false === $base ) { + throw new \Exception( 'could not resolve config/php' ); + } + $conf_dir = $base . '/php/conf.d'; + $content = self::read_custom_ini( $file, $conf_dir ); + } catch ( \Exception $e ) { + EE::warning( "Skipped disabling session.upload_progress for $site->site_url: {$e->getMessage()}. $manual" ); return; } @@ -262,39 +264,45 @@ private function update_site( $site ) { return; } - $backup = null; - if ( ! $created ) { - $backup = $this->backup_root . '/' . $site->site_url . '/custom.ini'; - try { - $this->fs->mkdir( dirname( $backup ), 0700 ); - $this->fs->copy( $file, $backup, true ); - $this->fs->chmod( $backup, fileperms( $file ) & 0777 ); - $this->fs->touch( $backup, filemtime( $file ) ); - } catch ( \Throwable $e ) { - EE::warning( "Skipped disabling session.upload_progress for $site->site_url: could not back up custom.ini ({$e->getMessage()}). $manual" ); + // Rollback reads the file back with the same limit. + if ( strlen( $new_content ) > self::MAX_SIZE ) { + EE::warning( "Skipped disabling session.upload_progress for $site->site_url: custom.ini would be larger than " . self::MAX_SIZE . " bytes. $manual" ); + + return; + } - return; + $backup = $this->backup_root . '/' . $site->site_url . '/custom.ini'; + try { + $stat = @lstat( $file ); + $this->fs->mkdir( dirname( $backup ), 0700 ); + $this->fs->dumpFile( $backup, $content ); + if ( $stat ) { + $this->fs->chmod( $backup, $stat['mode'] & 0777 ); + $this->fs->touch( $backup, $stat['mtime'] ); } + } catch ( \Throwable $e ) { + EE::warning( "Skipped disabling session.upload_progress for $site->site_url: could not back up custom.ini ({$e->getMessage()}). $manual" ); + + return; + } + + // In place, so owner, mode and inode stay (macOS bind-mounts this single file); a failed write puts the old content back itself. + try { + self::write_custom_ini( $file, $conf_dir, $new_content, $content ); + } catch ( \Exception $e ) { + // Kept: if putting the old content back failed too, it is the only copy. + EE::warning( "Could not disable session.upload_progress for $site->site_url: {$e->getMessage()}. The original custom.ini is $backup. $manual" ); + + return; } $this->changed[ $site->site_url ] = [ 'site' => $site, 'file' => $file, + 'dir' => $conf_dir, 'backup' => $backup, ]; - // Written in place: keeps owner, mode and inode (macOS bind-mounts this single file). - if ( ! $this->write_in_place( $file, $new_content ) ) { - $this->restore_file( $site->site_url ); - EE::warning( "Could not disable session.upload_progress for $site->site_url: could not write custom.ini. $manual" ); - - return; - } - - if ( $created ) { - $this->match_owner( $file, $conf_dir ); - } - $id = $site->site_enabled ? $this->get_php_container( $site ) : ''; if ( null !== $id && '' !== $id ) { $this->containers[ $site->site_url ] = $id; @@ -327,18 +335,14 @@ private function restore_file( string $site_url ) { $entry = $this->changed[ $site_url ]; unset( $this->changed[ $site_url ] ); - if ( null === $entry['backup'] ) { - if ( ! @unlink( $entry['file'] ) && file_exists( $entry['file'] ) ) { - EE::warning( "Could not remove {$entry['file']} added by the session.upload_progress migration." ); + try { + $content = @file_get_contents( $entry['backup'] ); + if ( false === $content ) { + throw new \Exception( 'could not read the backup' ); } - - return; - } - - $content = @file_get_contents( $entry['backup'] ); - // Skip the write when it never happened, e.g. on an immutable file. - if ( false === $content || ( @file_get_contents( $entry['file'] ) !== $content && ! $this->write_in_place( $entry['file'], $content ) ) ) { - EE::warning( "Could not restore {$entry['file']}; its original is {$entry['backup']}" ); + self::write_custom_ini( $entry['file'], $entry['dir'], $content ); + } catch ( \Exception $e ) { + EE::warning( "Could not restore {$entry['file']} ({$e->getMessage()}); its original is {$entry['backup']}" ); return; } @@ -347,30 +351,42 @@ private function restore_file( string $site_url ) { } /** - * @param string $file File to overwrite without replacing it. - * @param string $content New content. + * Read custom.ini, which the site's php container can swap for a symlink, as can every directory above it in its config volume. + * + * Only through site-command's checked handle: PHP can't open a path without following a symlink, so a path check alone leaves a race. * - * @return bool Whether the file now holds exactly $content. + * @param string $file custom.ini. + * @param string $dir Real path of its directory. + * + * @return string + * @throws \Exception */ - private function write_in_place( string $file, string $content ) { + private static function read_custom_ini( string $file, string $dir ) { - $written = @file_put_contents( $file, $content ); - clearstatcache( true, $file ); + if ( ! function_exists( '\EE\Site\Utils\get_container_file_contents' ) ) { + throw new \Exception( 'this site-command version cannot read custom.ini safely' ); + } - return strlen( $content ) === $written && @file_get_contents( $file ) === $content; + return \EE\Site\Utils\get_container_file_contents( $file, $dir, self::MAX_SIZE ); } /** - * Give a new file the owner and group of its directory. + * Overwrite custom.ini in place, checked like read_custom_ini(). + * + * @param string $file custom.ini. + * @param string $dir Real path of its directory. + * @param string $content New content. + * @param string|null $expected Content it must still hold; null for any. * - * @param string $file File. - * @param string $dir Directory. + * @throws \Exception When it isn't written; the old content is put back after a partial write. */ - private function match_owner( string $file, string $dir ) { + private static function write_custom_ini( string $file, string $dir, string $content, ?string $expected = null ) { + + if ( ! function_exists( '\EE\Site\Utils\put_container_file_contents' ) ) { + throw new \Exception( 'this site-command version cannot write custom.ini safely' ); + } - @chmod( $file, 0644 ); - @chown( $file, fileowner( $dir ) ); - @chgrp( $file, filegroup( $dir ) ); + \EE\Site\Utils\put_container_file_contents( $file, $dir, $content, $expected, self::MAX_SIZE ); } /**