WinCache 런타임 구성

이 함수의 동작은 php.ini의 설정에 영향을 받습니다.

다음 표는 WinCache 확장에서 제공하는 구성 설정을 나열하고 설명합니다.

WinCache 구성 옵션

Name Default Minimum Maximum Changeable Changelog
wincache.fcenabled "1" "0" "1" PHP_INI_ALL WinCache 1.0.0부터 사용 가능
wincache.fcenabledfilter "NULL" "NULL" "NULL" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.fcachesize "24" "5" "255" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.fcndetect "1" "0" "1" PHP_INI_SYSTEM WinCache 1.1.0부터 사용 가능
wincache.maxfilesize "256" "10" "2048" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.ocenabled "1" "0" "1" PHP_INI_ALL WinCache 1.0.0부터 사용 가능합니다. 2.0.0.0부터 제거됨
wincache.ocenabledfilter "NULL" "NULL" "NULL" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능합니다. 2.0.0.0부터 제거됨
wincache.ocachesize "96" "15" "255" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능합니다. 2.0.0.0부터 제거됨
wincache.filecount "4096" "1024" "16384" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.chkinterval "30" "0" "300" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.ttlmax "1200" "0" "7200" PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.enablecli 0 0 1 PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.ignorelist NULL NULL NULL PHP_INI_ALL WinCache 1.0.0부터 사용 가능
wincache.namesalt NULL NULL NULL PHP_INI_SYSTEM WinCache 1.0.0부터 사용 가능
wincache.ucenabled 1 0 1 PHP_INI_SYSTEM WinCache 1.1.0부터 사용 가능
wincache.ucachesize 8 5 85 PHP_INI_SYSTEM WinCache 1.1.0부터 사용 가능
wincache.scachesize 8 5 85 PHP_INI_SYSTEM WinCache 1.1.0부터 사용 가능
wincache.rerouteini NULL NULL NULL PHP_INI_SYSTEM WinCache 1.2.0부터 사용 가능합니다. 1.3.7부터 제거됨
wincache.reroute_enabled 1 0 1 PHP_INI_SYSTEM | PHP_INI_PERDIR WinCache 1.3.7부터 사용 가능
wincache.srwlocks 1 0 1 PHP_INI_SYSTEM WinCache 1.3.6.3부터 사용 가능합니다. 2.0.0.0부터 제거됨
wincache.filemapdir NULL NULL NULL PHP_INI_SYSTEM WinCache 1.3.7.4부터 사용 가능

PHP_INI_* 모드에 대한 자세한 내용과 정의는 구성 설정을 설정할 수 있는 위치를 참조하세요. 다음은 구성 지시문에 대한 간단한 설명입니다.

wincache.fcenabled bool
파일 캐시 기능을 활성화하거나 비활성화합니다.
wincache.fcenabledfilter string
파일 캐시를 활성화하거나 비활성화해야 하는 IIS 웹 사이트 식별자의 쉼표로 구분된 목록을 정의합니다. 이 설정은 wincache.fcenabled와 함께 작동합니다. wincache.fcenabled가 1로 설정되면 wincache.fcenabledfilter에 나열된 사이트에서 파일 캐시가 꺼집니다. wincache.fcenabled가 0으로 설정되면 wincache.fcenabledfilter에 나열된 사이트에서 파일 캐시가 켜집니다.
wincache.fcachesize int
파일 캐시에 할당된 최대 메모리 크기(MB)를 정의합니다. 캐시된 모든 파일의 총 크기가 이 설정에 지정된 값을 초과하면 대부분의 오래된 파일이 파일 캐시에서 제거됩니다.
wincache.fcndetect bool
파일 변경 알림 감지 기능을 활성화하거나 비활성화합니다. 파일 변경 알림이 지원되는 경우 파일 시스템에서 해당 파일이 수정되는 즉시 opcode 및 파일 캐시 항목을 새로 고치는 데 사용됩니다. 예를 들어 네트워크 파일 공유를 사용할 때 파일 변경 알림이 지원되지 않는 경우 wincache는 wincache.chkinterval에 지정된 정기적인 시간 간격으로 파일 변경 사항을 폴링합니다.
wincache.maxfilesize int
단일 파일이 캐시될 수 있는 최대 크기(KB)를 정의합니다. 파일 크기가 지정된 값을 초과하면 파일이 캐시되지 않습니다. 이 설정은 파일 캐시에만 적용됩니다.
wincache.ocenabled bool

경고 이 옵션은 2.0.0.0부터 제거되었습니다.

opcode 캐시 기능 활성화 또는 비활성화

wincache.ocenabledfilter string

경고 이 옵션은 2.0.0.0부터 제거되었습니다.

opcode 캐시를 활성화하거나 비활성화해야 하는 IIS 웹 사이트 식별자의 쉼표로 구분된 목록을 정의합니다. 이 설정은 wincache.ocenabled와 함께 작동합니다. wincache.ocenabled가 1로 설정되면 wincache.ocenabledfilter에 나열된 사이트에서 opcode 캐시가 꺼집니다. wincache.ocenabled가 0으로 설정되면 wincache.ocenabledfilter에 나열된 사이트에서 opcode 캐시가 켜집니다.

wincache.ocachesize int

경고 이 옵션은 2.0.0.0부터 제거되었습니다.

opcode 캐시에 할당된 최대 메모리 크기(MB)를 정의합니다. 캐시된 opcode 크기가 지정된 값을 초과하면 대부분의 오래된 opcode가 캐시에서 제거됩니다. opcode 캐시 크기는 파일 캐시 크기보다 3배 이상 커야 합니다. 그렇지 않은 경우 opcode 캐시 크기가 자동으로 증가합니다.

wincache.filecount int
시작 시 적절한 메모리 크기가 할당되도록 확장에 의해 캐시될 것으로 예상되는 파일 수를 정의합니다. 파일 수가 지정된 값을 초과하면 WinCache는 필요에 따라 더 많은 메모리를 다시 할당합니다.
wincache.chkinterval int
캐시를 새로 고치기 위해 확장 프로그램이 파일 변경 사항을 확인하는 빈도(초)를 정의합니다. 0으로 설정하면 캐시 새로 고침이 비활성화됩니다. 파일 변경 사항은 해당 파일에 대한 캐시 항목이 스캐빈저에 의해 제거되거나 IIS 응용 프로그램 풀이 재활용되거나 wincache_refresh_if_changed 함수가 호출되지 않는 한 캐시에 반영되지 않습니다.
wincache.ttlmax int
사용되지 않고 캐시된 항목의 최대 수명(초)을 정의합니다. 0으로 설정하면 캐시 스캐빈저가 비활성화되므로 IIS 작업자 프로세스의 수명 동안 캐시된 항목이 캐시에서 제거되지 않습니다.
wincache.enablecli bool
PHP가 명령줄(CLI) 모드에서 실행 중일 때 캐싱이 활성화되는지 정의합니다.
wincache.ignorelist string

확장에 의해 캐시되지 않아야 하는 파일 목록을 정의합니다. 파일 목록은 파일 이름만 사용하여 지정하고 파이프 기호("|")로 구분합니다.

예 #1 wincache.ignorelist 예

wincache.ignorelist = "index.php|misc.php|admin.php"
                    
wincache.namesalt string
공유 메모리에 저장된 확장 특정 개체의 이름을 지정할 때 사용할 문자열을 정의합니다. 이것은 IIS 작업자 프로세스 내의 다른 응용 프로그램이 공유 메모리에 액세스하려고 할 때 발생할 수 있는 충돌을 방지하는 데 사용됩니다. 네임솔트 문자열의 길이는 8자를 초과할 수 없습니다.
wincache.ucenabled bool
사용자 캐시 기능을 활성화하거나 비활성화합니다.
wincache.ucachesize int
사용자 캐시에 할당되는 최대 메모리 크기(MB)를 정의합니다. 사용자 캐시에 저장된 변수의 총 크기가 지정된 값을 초과하면 가장 오래된 변수가 캐시에서 제거됩니다.
wincache.scachesize int
세션 캐시에 할당되는 최대 메모리 크기(MB)를 정의합니다. 세션 캐시에 저장된 데이터의 총 크기가 지정된 값을 초과하면 가장 오래된 데이터가 캐시에서 제거됩니다.
wincache.rerouteini string

경고 이 옵션은 1.3.7에서 제거되었습니다. 1.3.7과 유사한 기능에 대해서는 wincache.reroute_enabled를 참조하십시오.

구현을 WinCache 함수로 대체해야 하는 PHP 함수 목록이 포함된 reroute.ini 파일에 대한 절대 또는 관련 경로를 지정합니다. 상대 경로가 지정되면 php-cgi.exe 파일의 위치에 대한 상대 경로로 간주됩니다.

wincache.reroute_enabled bool
파일 캐시를 통한 특정 파일 I/O 함수의 경로 재지정을 활성화하거나 비활성화합니다.
wincache.srwlocks bool

경고 이 옵션은 2.0.0.0부터 제거되었습니다.

공유 리더/라이터 잠금 사용을 활성화하거나 비활성화합니다. 비활성화는 WinCache의 교착 상태 문제를 해결할 때 유용합니다.

wincache.filemapdir string
WinCache가 공유 메모리 세그먼트에 사용되는 임시 파일을 저장할 디렉터리의 절대 경로를 지정합니다. 이 디렉토리는 네트워크 파일 시스템이 아닌 로컬 시스템에 있어야 합니다. 디렉토리가 지정되지 않으면 WinCache는 모든 공유 메모리 세그먼트에 대해 Windows 시스템 페이지 파일을 사용합니다.