HeuJung
062a88ca04
설치 단계와 코어 부팅의 정책이 엇갈려 있었다. 인스톨러는 root 를 자유롭게 허용하면서, 설치 후 부팅은 같은 값을 보고 확장 로딩 전체를 조용히 스킵했다. 설치는 성공하지만 이후 깨진 화면만 뜨고 원인은 로그 한 줄에만 남았다. 판정을 프레임워크 의존성 0 인 공용 SSoT 로 모아 인스톨러와 코어가 같은 답을 내게 하고, 설치 단계에서 서버 2경로로 차단하며, 설치 후 변경은 전용 에러 페이지로 드러낸다. 가드를 boot 가 아닌 미들웨어에 두어 artisan 이 죽지 않게 해 복구 수단을 남겼다. admin 은 일반 권한 운영 계정 오차단을 막기 위해 차단 목록에서 제외했다. OPcache 는 상태 조회 경로 자체가 없어 성능 저하를 인지할 방법이 없었다. 설치 단계 경고(비차단)와 관리자 정보 탭 표시를 같은 판정 SSoT 로 추가했다. 확장 로드 여부만으로는 부족해 opcache.enable 지시자까지 확인하며, ini_get 이 차단된 환경은 "확인 불가"로 폴백해 경고도 차단도 하지 않는다.
60 lines
2.4 KiB
PHP
60 lines
2.4 KiB
PHP
<?php
|
|
|
|
namespace App\Support;
|
|
|
|
/**
|
|
* OPcache 활성화 상태 판정 (인스톨러·코어 공용 SSoT).
|
|
*
|
|
* 인스톨러(`public/install/`)는 Laravel 오토로드 없이 동작하는 순수 PHP 이므로
|
|
* 이 클래스는 파사드·헬퍼 등 프레임워크 의존성을 일절 참조하지 않는다.
|
|
* 인스톨러는 `require_once` 로 이 파일을 직접 로드해 사용한다.
|
|
*
|
|
* 확장 로드 여부만으로는 부족하다 — `Zend OPcache` 가 로드돼 있어도
|
|
* `opcache.enable=0` 이면 실제로는 동작하지 않는다.
|
|
*/
|
|
final class OpcacheStatus
|
|
{
|
|
/** OPcache PHP 확장명 */
|
|
public const EXTENSION_NAME = 'Zend OPcache';
|
|
|
|
/** OPcache 활성화 여부를 담은 php.ini 지시자 */
|
|
public const ENABLE_DIRECTIVE = 'opcache.enable';
|
|
|
|
/**
|
|
* OPcache 상태를 조회합니다.
|
|
*
|
|
* `enabled` 가 null 이면 "확인 불가" 를 뜻합니다 — `ini_get` 이
|
|
* `disable_functions` 로 차단된 환경에서 발생하며, 경고도 차단도 하지 않습니다.
|
|
*
|
|
* 두 콜백 파라미터는 테스트에서 환경을 주입하기 위한 것으로,
|
|
* 운영 코드는 인수 없이 호출합니다.
|
|
*
|
|
* @param callable|null $extensionLoaded 확장 로드 여부 판정 콜백 (기본: extension_loaded)
|
|
* @param callable|null $iniGet php.ini 지시자 조회 콜백 (기본: ini_get)
|
|
* @return array{loaded: bool, enabled: bool|null} 확장 로드 여부와 활성화 여부
|
|
*/
|
|
public static function probe(?callable $extensionLoaded = null, ?callable $iniGet = null): array
|
|
{
|
|
$extensionLoaded ??= static fn (string $name): bool => extension_loaded($name);
|
|
$iniGet ??= static fn (string $key) => ini_get($key);
|
|
|
|
if (! $extensionLoaded(self::EXTENSION_NAME)) {
|
|
return ['loaded' => false, 'enabled' => false];
|
|
}
|
|
|
|
try {
|
|
$raw = $iniGet(self::ENABLE_DIRECTIVE);
|
|
} catch (\Throwable) {
|
|
// ini_get 이 disable_functions 로 차단된 환경 — 확인 불가
|
|
return ['loaded' => true, 'enabled' => null];
|
|
}
|
|
|
|
// ini_get 은 지시자를 못 읽으면 false 를 반환한다 (값 '0' 과 구분해야 함)
|
|
if ($raw === false || $raw === null || $raw === '') {
|
|
return ['loaded' => true, 'enabled' => null];
|
|
}
|
|
|
|
return ['loaded' => true, 'enabled' => filter_var($raw, FILTER_VALIDATE_BOOLEAN)];
|
|
}
|
|
}
|