
PHP INI, FPM 풀 및 사이트 설정에서 session.upload_progress.enabled를 감사하고 백업 및 롤백과 함께 CVE-2026-115560 완화 조치를 적용하는 Bash 유틸리티입니다.
PHP 프로젝트에서 권장하는 임시 완화 조치를 적용하고 PHP 구성을 찾기 위한 독립 실행형 Bash 유틸리티:
session.upload_progress.enabled = 0
상태 (2026-10-24): 임시 완화 조치이며, PHP 보안 패치가 아닙니다. 2026-10-23에 PHP 프로젝트는 발생 가능성이 낮은 RCE 시나리오를 해결하기 위해 다음 정기 버그 수정 릴리스까지 PHP 세션 업로드 진행률 기능을 비활성화할 것을 권고했습니다. 영향을 받는 애플리케이션 설정은 구성에서 session.serialize_handler을 php_binary / php_serialize로 설정한 뒤, session_start() 이전에 런타임에서 php으로 변경하면서 업로드 진행률은 활성화된 상태로 유지하는 경우를 포함합니다. PHP 공지에 따르면 런타임에서 세션 직렬화기를 변경하지 않는 애플리케이션은 이 특정 시나리오에 노출되지 않습니다. 이 유틸리티는 보수적인 구성 수준의 우회 조치를 적용하며, 익스플로잇이나 취약점 스캔을 시도하지 않습니다.
root로 실행하기 전에 스크립트를 검토하십시오:
git clone https://github.com/ivst/CVE-2026-115560.git
cd CVE-2026-115560
bash -n php-upload-progress-mitigate.sh
sudo bash php-upload-progress-mitigate.sh --check
sudo bash php-upload-progress-mitigate.sh --apply
# Read the changes; reload validated managed PHP-FPM / Apache services:
sudo bash php-upload-progress-mitigate.sh --apply --reload
sudo bash php-upload-progress-mitigate.sh --check
# Optional: inspect running Docker PHP-FPM configurations as well (read-only):
sudo bash php-upload-progress-mitigate.sh --check --check-docker
발견된 PHP-FPM 및 Apache systemd 서비스를 완화 조치 적용의 일환으로 검증하고 정상적으로 재로드하려면:
sudo bash php-upload-progress-mitigate.sh --apply --reload
스크립트는 실행 중인 PID와 systemd MainPID를 통해 관리되는 PHP-FPM 마스터를 식별하고, 마스터 프로세스에서 구성 경로를 읽고, -t -y <config>로 해당 FPM 바이너리를 실행한 다음, CanReload=yes인 경우에만 systemctl reload를 사용합니다. Apache는 정상적인 재로드 전에 구성 테스트를 받습니다. 이 헬퍼는 알 수 없는 FPM 마스터, 검증되지 않은 구성 또는 재로드 지원이 없는 서비스에 자동으로 신호를 보내지 않습니다. 수동 검토가 필요한 경우 경고를 출력하고 상태 2로 종료합니다.
--apply --restart를 사용하면 명시적인 강제 재시작이 여전히 가능하지만, 필요한 경우가 아니라면 프로덕션 사이트에는 권장되지 않습니다:
sudo bash php-upload-progress-mitigate.sh --apply --restart
경고: 정상적인(graceful) 재로딩조차도 짧은 시간 동안 오류를 일으키거나 일부 장시간 실행 중인 요청을 종료시킬 수 있습니다. 파일 변경 사항은 워커가 재로딩 또는 재시작하지 않는 한 실행 중인 워커에 자동으로 적용되지 않습니다. 이 유틸리티는 발견된 PHP 레이아웃 외부의 컨테이너나 패널이 관리하는 프로세스를 완전히 포괄한다고 보장할 수 없습니다. 유지보수 시간대를 선호하고 실제 웹-SAPI 설정을 확인하십시오.
php-upload-progress-mitigate.sh [--check|--apply] [--reload|--restart] [--check-docker] [--root=/offline/root] [--site-root=/path]
php-upload-progress-mitigate.sh --rollback=/absolute/backup/directory [--apply] [--root=/offline/root]
| 플래그 | 목적 |
|---|---|
--check | 기본값. 정적 검사만 수행하며 파일을 수정하지 않습니다. |
--check-docker | 라이브 호스트 --check와 함께 선택적으로 사용: Docker CLI를 사용하여 실행 중인 Docker 컨테이너 내의 PHP-FPM 및 PHP 내장 웹 서버를 검사합니다. 변경이나 재시작은 없습니다. |
--apply | 백업과 함께 완화 조치를 기록합니다. root 권한이 필요합니다. |
--reload | --apply와 함께 사용하면 관리되는 PHP-FPM/Apache systemd 서비스를 검증하고 정상적으로 다시 로드합니다. 지원되지 않거나 검증되지 않은 서비스는 경고와 함께 건너뜁니다. |
--restart | --apply과 함께 사용하면 적격한 관리 서비스를 검증하고 강제 재시작합니다. 강제 재시작을 의도하는 경우에만 사용하십시오. |
--root=/path | 오프라인 파일시스템 트리에 대해 검사/적용합니다. 이 모드에서는 서비스를 절대 재시작하지 않습니다. 테스트/오프라인 유지보수용입니다. |
--site-root=/path | 읽기 전용 재정의 스캔에 사이트 디렉터리를 추가합니다. 여러 디렉터리의 경우 반복하십시오. --root과 함께 사용하면 오프라인 트리 내부의 경로입니다(예: /srv/apps). |
--rollback=/path | 하나의 백업 디렉터리 복원을 미리 봅니다. 백업된 파일을 복원하고 해당 실행에서 생성된 파일을 제거하려면 --apply을 추가하십시오. 서비스 작업, Docker 또는 사이트 스캔과 함께 사용할 수 없습니다. |
종료 코드: 감지된 경고가 없으면 0, 치명적/사용 오류의 경우 1, 수동 검토가 필요하면 2입니다. --apply 실행은 추가로 처리되지 않은 경고가 발생하면 완화 파일을 기록하고 2을 반환할 수 있습니다.
이 스크립트는 Debian/Ubuntu, RHEL 계열 시스템, Remi, 표준 PHP 설치 경로 및 일반적인 호스팅 패널에서 사용되는 일반적인 레이아웃을 스캔하며, FASTPANEL의 내부 애플리케이션 런타임(/opt/fphp/php.ini, /opt/fphp/conf.d, /opt/fphp/etc/php-fpm.d)도 포함합니다. 감지된 INI 트리에 대해서는 늦게 로드되는 zzzzzz-cve-2026-115560.ini 재정의를 기록하거나, 스캔 디렉터리가 없을 경우 php.ini을 편집합니다. 또한 php-cli.ini(PHP가 php.ini 대신 로드할 수 있는 파일)와 같은 SAPI별 대체 파일을 감지하고, 패널 관리 설치에서 사용되는 /opt/php85/conf.d과 같은 형제 스캔 디렉터리를 확인합니다. 또한 감지된 PHP-FPM 풀 섹션에 php_admin_value[session.upload_progress.enabled] = 0을 삽입하여 해당 풀에서 이 설정에 대한 이후의 디렉터리별 재정의를 방지합니다.
수정된 파일의 백업과 변경 매니페스트는 다음 위치에 저장됩니다:
/var/backups/php-upload-progress/<UTC timestamp>-<PID>/
변경된 기존 파일만 백업됩니다. 백업에는 PHP-FPM 구성의 비밀이 포함될 수 있으며 제한적인 상위 디렉터리 아래에 생성되므로 비공개로 유지하십시오. 각 원본 파일은 한 번의 실행당 한 번만 백업되며, 여러 번 업데이트되더라도 마찬가지입니다. 새 스냅샷은 state.tsv에 있는 버전이 지정된 v2 레코드를 사용하며, 원본 및 적용된 내용의 SHA-256 해시와 적용된 대상 장치/inode, UID/GID, 모드, 크기, 수정 시간 및 변경 시간을 포함합니다. 액세스 시간은 제외되므로 대상을 읽어도 무효화되지 않습니다.
롤백하려면 --apply가 출력한 정확한 백업 디렉터리를 사용하십시오:
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID --apply
첫 번째 명령은 계획만 미리 보여줍니다. 롤백은 파일을 변경하기 전에 전체 계획을 검증하고, 상위 디렉터리와 파일 inode를 고정 및 잠근 다음, 각 복원/제거 직전에 대상 콘텐츠, ID 및 메타데이터를 다시 확인합니다. 복원은 고정된 디렉터리를 사용하므로 상위 항목을 교체해도 쓰기 위치를 바꿀 수 없습니다. 편집되었거나 누락된 대상, 심볼릭 링크, 선택한 루트 밖의 경로, 사용 중인 잠금, 불완전한 스냅샷은 거부합니다. 대상, 백업 및 그 상위 항목은 root가 소유해야 하며 그룹/기타 사용자가 쓸 수 없어야 합니다. /tmp과 같은 root 소유의 스티키 디렉터리는 허용됩니다. 충돌은 수동으로 해결하십시오. 강제 옵션은 없습니다. 롤백에는 Linux /proc 및 flock(util-linux)가 필요하고, 적용에는 flock가 필요합니다. 동일한 선택 루트에 대한 적용/롤백 작성자는 직렬화됩니다. 잠금은 권고적입니다. 롤백 중에는 외부 구성 편집기와 구성 관리를 일시 중지하십시오. 협조하지 않는 작성자는 원자적 compare-and-swap 보장의 적용을 받지 않습니다. 롤백은 백업 디렉터리를 유지하고, 서비스를 재시작하지 않으며, 트랜잭션이 아닙니다. I/O 실패나 복원 중 발견된 충돌로 인해 이전 대상이 복원된 상태로 남을 수 있습니다. 이후 구성을 검증하고 영향을 받은 워커를 다시 로드하십시오. 보호를 되돌리면 업로드 진행 표시가 다시 활성화될 수 있습니다. state.tsv가 없거나 해시 전용 상태 레코드가 있는 이전 스냅샷은 changes.tsv에서 수동으로 복원해야 합니다. 동일한 바이트로 대상을 교체하거나, 소유자/그룹/모드를 변경하거나, 편집한 후 되돌리는 경우에도 자동 롤백이 무효화됩니다. 복사된 파일 시스템 트리는 inode ID가 다를 수도 있습니다.
이 스크립트는 또한 검사 및 적용 모드 모두에서 .htaccess, .user.ini 및 사이트별 php.ini의 활성 설정을 찾기 위해 /var/www, /home, /srv/www 및 /var/www/vhosts를 스캔합니다. 사이트 파일을 편집하거나 모든 파일이 사이트의 SAPI에 유효하다고 가정하지 않고, 업로드 진행 표시를 활성화할 수 있는 값에 대해 경고합니다. 디렉터리 심볼릭 링크, 별도 마운트 및 cPanel virtfs 하위 트리는 건너뜁니다. 필요할 경우 실제 위치를 별도로 스캔하십시오. 파일 심볼릭 링크(깨진 링크 포함)와 건너뛴 마운트 경계는 깨끗한 결과 대신 경고를 생성합니다. Apache 지시문 이름은 대소문자를 구분하지 않고 일치합니다. 명시적 --check --site-root=... 감사는 인식된 호스트 PHP 설치 없이도 작동합니다. --apply는 여전히 지원되는 호스트 레이아웃이 필요합니다. 경고 또는 불완전한 스캔은 종료 코드 2을 반환합니다.
라이브 호스트 CLI 검사에는 일반적인 위치의 cPanel EA4, Plesk, CloudLinux, Remi 및 FASTPANEL 바이너리가 포함됩니다. CLI 프로브를 실행하기 전에 도구는 root 소유의 실행 파일과 그룹/기타 쓰기 권한이 없는 root 소유의 상위 항목을 요구합니다(root 소유의 스티키 디렉터리는 허용됨). 정규 경로를 검증하고 실행하므로 일반적인 alternatives 심볼릭 링크는 계속 지원됩니다. 신뢰할 수 없는 바이너리와 실패한 CLI 쿼리는 경고를 생성하고 건너뜁니다. 이러한 검사는 여전히 실행 중인 웹사이트에서 사용되는 값을 확립하지 않습니다.
출력은 파일 시스템/정적 추정치입니다. 라이브 호스트의 --check에서 스크립트는 PHP-FPM 마스터 프로세스도 인벤토리화하고, 별도 조사를 위해 Docker/컨테이너 마스터를 표시하며, 스캔되지 않은 호스트 FPM 구성 경로를 식별합니다. --check-docker을 추가하여 docker ps --no-trunc 및 docker top를 사용해 실행 중인 Docker 컨테이너에서 PHP-FPM 마스터 및 내장 PHP 웹 서버(php artisan serve, php -S)를 검색한 다음, docker inspect 및 docker exec를 통해 해당 설정을 검사하십시오(옵트인 전용). docker top는 기본(이식 가능한) 프로세스 목록으로 실행됩니다. 도구는 CMD/COMMAND 열을 추출하여 일부 이전 Docker/ps 조합에서 실패하는 -eo args을 피합니다. 이는 호스트 프로세스 목록에 컨테이너 PID가 표시될 것을 요구하지 않습니다. 인식된 호스트 PHP INI 트리가 없는 Docker 전용 호스트도 이 모드에서 지원됩니다. php -i, php --ini 및 php -r ...는 CLI SAPI 값만 확립하며, 각 가상 호스트, PHP-FPM 풀, PHP 컨테이너 또는 FastCGI 프로세스에서 보이는 값은 아닙니다.
유효한 web-SAPI 값을 확인하려면 특정 가상 호스트에 임시 접근 제어된 테스트 파일을 넣고 해당 사이트의 PHP 핸들러를 통해 로드하십시오:
<?php
header('Content-Type: text/plain');
echo 'SAPI: ', PHP_SAPI, "\n";
echo 'session.upload_progress.enabled: ', ini_get('session.upload_progress.enabled'), "\n";
테스트 후 이 임시 파일을 즉시 삭제하십시오. 예상 값은 0(또는 Off)입니다. 관련된 각 PHP 런타임에 대해 반복하십시오. phpinfo() 또는 이 테스트 엔드포인트를 공개적으로 노출하지 마십시오.
이것은 모든 PHP 설치에 대한 완전한 보장이 아닙니다. 이전 스크립트 릴리스는 0를 포함하는 늦게 로드된 ...ini가 있음에도 불구하고 INI ... =1을 잘못 보고할 수 있었으며, 특히 구형 awk 구현에서 그러했습니다. 현재 릴리스는 awk 대신 Bash를 사용하여 INI 값을 파싱합니다. 스크립트를 업데이트하고 --apply를 고려하기 전에 --check을 다시 실행하십시오. 특히 다음에 주의하십시오: