ownCloud 10에서 "PHP 메모리 제한이 권장 값 미만" 오류를 해결하는 방법

원하는 결과는 단순히 "경고가 사라지는 것"이 ​​아닙니다. 올바른 해결 방법은 ownCloud 10을 실제로 서비스하는 PHP 프로세스가 최소 512MB의 메모리 제한을 보고하고, ownCloud 관리자 경고가 사라지고, 예약된 작업이나 CLI 작업도 적절한 제한을 사용하며, 호스트에 PHP, 웹 서버, 데이터베이스 및 백그라운드 작업을 과도한 스와핑 없이 실행할 수 있는 충분한 물리적 메모리가 확보되는 것을 의미합니다.

ownCloud Classic 10.16의 공식 Docker 환경은 OWNCLOUD_MEMORY_LIMIT=512M권장 기본값으로 를 사용합니다. ownCloud 문서에서는 웹 서버에서 사용하는 PHP 구성과 에서 사용하는 PHP 구성을 구분하고 있습니다 php-cli. 이러한 구분 때문에 관리자가 를 변경하고 memory_limit서비스를 재시작해도 동일한 경고가 계속 표시되는 경우가 있습니다.

이 가이드는 가장 영향이 적은 점검부터 시작하여 Apache, PHP-FPM, CLI 및 Docker 경로를 보여줍니다. 또한 제한을 추가로 늘려야 하는 경우와 실제 문제가 PHP 설정 자체가 아니라 호스트 RAM 부족인 경우를 설명합니다.

성공이란 무엇인가

1. 경고 메시지와 ownCloud에서 인식하는 값을 확인하십시오.

ownCloud 관리자 설정에 접속하여 메모리 제한 경고를 확인하십시오. 변경하기 전에 ownCloud 버전, PHP 버전, 웹 서버 유형 및 현재 메모리 제한을 기록해 두세요. 이렇게 하면 기준점을 확보하고 여러 PHP 버전이 설치된 시스템에서 잘못된 PHP 설치를 변경하는 것을 방지할 수 있습니다.

ownCloud의 최신 10.16 문서에 따르면 서버 요구 사항은 사용자 수, 파일 수 및 활동에 따라 크게 달라집니다. Docker 구성은 OWNCLOUD_MEMORY_LIMIT=512M이러한 기본값을 설정하고 유지하도록 권장합니다. 따라서 512MB는 경고를 해결하기 위한 합리적인 기준선이지만, 모든 워크로드가 512MB 내에 처리될 수 있다는 보장은 아닙니다.

공식 참조 자료: ownCloud 배포 권장 사항 및 ownCloud Docker 환경 변수 .

2. CLI 값이 웹 서버를 나타낸다고 믿지 마십시오.

명령줄 PHP 프로세스가 무엇을 사용하는지 확인하려면 다음 명령을 실행하세요.

php --ini
php -r 'echo ini_get("memory_limit"), PHP_EOL;'

이는 cron 작업에 유용 occ하지만 웹 요청에서 실제로 사용되는 구성 파일을 증명하는 것은 아닙니다. ownCloud는 다음과 같은 별도의 구성 경로를 명시적으로 문서화하고 있습니다.

/etc/php/<version>/apache2/php.ini
/etc/php/<version>/fpm/php.ini
/etc/php/<version>/cli/php.ini

CLI에서 512M이라고 표시되는데 관리자 페이지에서 여전히 오류 메시지가 나타난다면, 이는 웹 서버가 다른 파일을 로드하고 있다는 강력한 신호입니다 php.ini.

ownCloud의 PHP 구성 참고 사항을 참조하십시오 . 해당 참고 사항에는 PHP 설정을 하나 이상의 INI 파일에서 변경해야 할 수 있다는 경고가 명시되어 있습니다.

3. 웹 요청에서 사용되는 PHP 설정을 찾습니다.

가장 신뢰할 수 있는 테스트 방법은 ownCloud를 제공하는 동일한 웹 스택에서 PHP를 검사하는 것입니다. ownCloud 문서에서는 임시 phpinfo.php페이지를 사용하는 방법을 설명합니다.

<?php phpinfo(); ?>

해당 파일을 웹 루트 폴더에 임시로 배치한 다음 브라우저에서 열고 다음 위치를 찾으세요.

• 구성 파일 로드됨
• 메모리 제한
• 서버 API

그런 다음 phpinfo 파일을 즉시 삭제하십시오 . ownCloud는 phpinfo 페이지를 공개 상태로 두면 민감한 서버 정보가 노출될 수 있다고 경고합니다.

브라우저 에 경고 메시지가 /etc/php/7.4/fpm/php.ini표시 된다면 , CLI 파일을 수정해도 경고가 사라지지 않은 이유를 정확히 알 수 있습니다.php --ini/etc/php/7.4/cli/php.ini

4. PHP-FPM: 웹 런타임 제한을 512MB로 상향 조정

일반적인 데비안 또는 우분투 설치 환경에서는 다음과 같습니다.

sudo nano /etc/php/7.4/fpm/php.ini

찾다:

memory_limit = 128M

그리고 다음과 같이 변경하세요:

memory_limit = 512M

경로에 설치된 PHP 버전을 사용하십시오. 그런 다음 필요한 경우 올바른 FPM 서비스와 웹 서버를 다시 시작하십시오.

sudo systemctl restart php7.4-fpm
sudo systemctl reload nginx

Apache에 proxy_fcgiPHP-FPM이 설치되어 있거나 다른 FPM 설정이 되어 있는 경우, PHP-FPM을 재시작하고 Apache를 다시 로드하십시오.

ownCloud는 PHP-FPM이 에서 PHP 설정을 가져오지 않는다는 점도 명시합니다 .htaccess. FPM을 사용하여 디렉터리별 재정의를 사용하는 경우, 적절한 php.ini, 풀 구성 또는 와 같은 환경에 맞는 지원되는 PHP/FPM 구성 메커니즘을 사용하십시오 .user.ini.

5. mod_php가 설치된 Apache: Apache PHP 설정을 수정합니다.

Apache가 PHP를 모듈로 직접 로드하는 경우 Apache 관련 파일을 편집하십시오.

sudo nano /etc/php/7.4/apache2/php.ini

세트:

memory_limit = 512M

그런 다음 Apache를 다시 시작하십시오.

sudo systemctl restart apache2

버전 번호를 기계적으로 복사하지 마십시오. Apache에서 실제로 로드된 버전을 확인하십시오. 여러 PHP 릴리스에 걸쳐 업그레이드된 시스템은 종종 . 아래에 여러 디렉터리가 남아 있는 경우가 있습니다 /etc/php/.

결과 기준은 간단합니다. 재시작 후 웹에서 실행되는 PHP 런타임에 새 값이 표시되어야 합니다. 여전히 128M이 표시된다면 다른 구성 레이어가 사용자의 수정 사항을 덮어쓰고 있는 것입니다.

6. occ 또는 cron이 메모리를 너무 적게 사용하는 경우 CLI 제한을 업데이트합니다.

관리자 웹 경고는 웹 런타임에 의해 발생하지만, occcron 작업은 PHP CLI를 사용합니다. ownCloud의 문서에는 이 점이 명시적으로 언급되어 있습니다.

편집하다:

sudo nano /etc/php/7.4/cli/php.ini

세트:

memory_limit = 512M

그런 다음 확인하십시오.

php -r 'echo ini_get("memory_limit"), PHP_EOL;'

CLI PHP의 경우 각 CLI 호출이 새로운 프로세스를 시작하기 때문에 서비스를 재시작할 필요가 없습니다. 하지만 cron 작업에서 다른 PHP 바이너리를 명시적으로 호출하는 경우, 현재 /usr/bin/php사용되는 바이너리가 무엇인지 정확히 확인해야 합니다.

ownCloud는 일반적으로 Debian/Ubuntu에서 occHTTP 사용자 권한으로 실행할 것을 권장합니다. 또한 공식 occ 문서 에서는 여러 버전의 PHP가 설치된 경우 웹 서버와 동일한 PHP 버전을 사용해야 한다고 경고합니다.www-dataocc

7. Docker: 컨테이너 내부 파일을 직접 수정하는 대신 OWNCLOUD_MEMORY_LIMIT를 사용하세요.

공식 ownCloud Docker 이미지를 사용하려면 문서에 설명된 환경 변수를 사용하십시오.

environment:
  OWNCLOUD_MEMORY_LIMIT: 512M

그런 다음 서비스를 다시 생성하세요.

docker compose up -d

임시 컨테이너 내부에서 직접 수정 작업을 하지 마십시오 php.ini. 컨테이너를 다시 생성하면 해당 변경 사항이 사라질 수 있습니다. ownCloud Docker 환경 공식 문서에서는 OWNCLOUD_MEMORY_LIMIT=512M이러한 기본 설정을 유지하도록 권장하고 있습니다.

Docker 호스트 자체의 메모리 제한이 엄격한 경우 컨테이너 제약 조건도 확인하십시오.

docker stats

PHP 메모리 제한을 512MB로 설정한다고 해서 컨테이너에 512MB의 여유 메모리가 자동으로 할당되는 것은 아닙니다. 단지 개별 PHP 요청이 사용할 수 있는 최대 메모리 용량을 제한하는 것일 뿐입니다. 컨테이너와 호스트는 동시에 실행되는 모든 PHP 워커와 기타 서비스를 위해 충분한 메모리를 여전히 필요로 합니다.

8. 올바른 서비스를 다시 시작하고 동일한 런타임에서 확인하십시오.

해당 서비스를 재시작한 후 임시 phpinfo 페이지 또는 ownCloud 관리자 개요를 다시 확인하십시오. 그런 다음 phpinfo 페이지를 삭제하십시오.

PHP-FPM을 변경했다면 다음 사항을 확인하세요.

sudo systemctl status php7.4-fpm
sudo systemctl status nginx

Apache 설정을 변경했다면:

sudo systemctl status apache2

ownCloud 관리자 페이지를 새로고침하세요. ownCloud가 예상 제한 이상으로 실행 중이라면 경고 메시지가 사라질 것입니다.

9. PHP 제한을 512MB 이상으로 높이기 전에 호스트 RAM을 확인하십시오.

달리다:

free -h
ps aux | grep php-fpm
vmstat 1

PHP 메모리 memory_limit사용량 제한은 스크립트별로 적용되는 상한선입니다. 이는 예약된 메모리 사용량이 아니며, 서버에 필요한 RAM 용량과도 다릅니다. 만약 PHP 워커 프로세스가 20개 있고 모든 요청에 ​​매우 많은 메모리를 사용할 수 있도록 허용한다면, 이론상 최악의 경우 서버의 RAM 용량을 훨씬 초과할 수 있습니다.

ownCloud의 튜닝 문서에서는 웹 서버 프로세스에 대해 동일한 일반적인 경고를 제공합니다. 총 메모리 사용량이 사용 가능한 RAM보다 낮게 유지되도록 프로세스 수를 조정하십시오. 그렇지 않으면 시스템에서 스와핑이 시작되어 성능이 저하됩니다. ownCloud Classic 튜닝 지침을 참조하십시오 .

512M 경고가 사라지고 정상적인 운영이 가능하다면, 단순히 수치를 높이기 위해 제한값을 늘릴 이유는 없습니다.

10. 512M에서도 여전히 "허용된 메모리 크기가 소진되었습니다"라는 오류가 발생하는 경우

권장 사항 경고 해제와 메모리 부족으로 인한 충돌은 서로 다른 문제입니다. 로그에 다음과 같은 메시지가 포함되어 있는 경우:

PHP Fatal error: Allowed memory size of ... bytes exhausted

메모리 사용량 증가를 유발하는 작업을 파악하십시오. 대규모 스캔, 암호화 작업, 외부 저장소 작업, 이미지 처리 또는 타사 앱은 각각 매우 다른 메모리 프로필을 가질 수 있습니다.

ownCloud 로그와 PHP/웹 서버 오류 로그를 확인하세요. 일반적인 ownCloud 설치는 구성된 데이터 디렉터리(일반적으로 `/etc/gl/localhost:1000`)에 자체 로그를 기록합니다 data/owncloud.log. "용량을 1GB로 늘리는 것"을 다음 단계로 바로 생각하지 마세요. 먼저 동일한 작업이 반복적으로 용량 제한에 도달하는지 확인하십시오.

만약 특정 관리 작업에 더 많은 메모리가 필요한 경우, 모든 웹 요청에 대해 전역적으로 큰 제한을 설정하는 것보다 CLI를 통해 해당 작업에만 메모리를 재정의하는 것이 더 안전할 수 있습니다.

php -d memory_limit=1G occ <command>

이 방법은 명령 및 메모리 동작을 이해한 경우에만 사용하십시오. PHP-FPM 또는 Apache를 통해 실행되는 웹 요청 문제를 해결하지는 않습니다.

php.ini 파일을 수정한 후에도 경고 메시지가 남아 있는 이유는 무엇일까요?

memory_limit과 업로드 제한을 혼동하지 마십시오.

memory_limitupload_max_filesizePHP 메모리를 늘린다고 해서 사용자가 더 큰 파일을 업로드할 수 있는 것은 post_max_size아닙니다. ownCloud 10.16 구성 노트에는 PHP 메모리를 최소 512MB로 설정해야 하며, 업로드 제한은 별도의 설정이 필요하다고 명시되어 있습니다 post_max_size.

실제 증상이 "대용량 파일 업로드 실패"인 경우, 프록시/웹 서버의 본문 크기 제한, 시간 초과 및 임시 디스크 용량을 점검하십시오 upload_max_filesize. post_max_size이러한 memory_limit설정을 변경하는 대신 단순히 더 높은 값을 사용하는 것은 효과가 없습니다.

최종 체크리스트

• ownCloud에서 경고 및 현재 값을 확인하십시오.
• ownCloud가 Apache mod_php를 사용하는지 아니면 PHP-FPM을 사용하는지 확인하십시오.
• 웹 런타임의 로드된 구성 파일을 찾으세요 .
• 웹 PHP 버전 memory_limit을 최소 .으로 설정하십시오 512M.
• occcron에서 더 낮은 제한값을 사용하는 경우 CLI PHP도 업데이트하세요 .
• Docker의 경우 OWNCLOUD_MEMORY_LIMIT=512M배포 환경에서 설정하십시오.
• PHP를 실제로 제공하는 서비스를 재시작하거나 다시 생성하십시오.
• CLI뿐만 아니라 웹 런타임에서도 값을 확인하십시오.
• ownCloud 경고 메시지가 사라졌는지 확인하십시오.
• 512MB를 초과하여 제한을 늘리기 전에 호스트 RAM 및 스왑 공간을 모니터링하십시오.

결론적으로

ownCloud 10에서 발생하는 "PHP 메모리 제한이 권장 값 미만" 오류를 해결하는 가장 간단한 방법은 ownCloud를 실제로 서비스하는 PHP 런타임의 메모리 제한을 512MB 이상으로 설정한 후, 동일한 런타임에서 해당 값을 확인하는 것입니다. 이 오류는 /etc/php/.../cli/php.iniownCloud가 PHP-FPM 또는 Apache를 통해 실행되는 동안 다른 구성 파일을 수정하는 경우에 가장 흔하게 발생합니다.

경고 메시지가 사라지고, 일반적인 작업이 정상적으로 진행되며, 호스트에 충분한 메모리 여유 공간이 확보되면 작업을 중지하십시오. 특정 작업 중에 PHP가 여전히 512MB의 메모리를 모두 소진하는 경우, "제한 값을 높이는 것"에서 벗어나 워크로드 진단으로 전환하십시오. 실패한 명령, 애플리케이션, 로그, 동시 실행 수 및 물리적 RAM을 검사하십시오. 워크로드가 이를 정당화하고 서버가 안전하게 지원할 수 있는 경우에만 더 큰 제한 값을 사용하는 것이 적절할 수 있습니다.