개요[편집 / 원본 편집]
라이믹스를 설치하고 운영하기 위한 요구사항이다. 웹 서비스를 제공할 웹서버(예: Apache, nginx), PHP 실행 환경, MySQL 또는 MariaDB가 필요하다. 아래 버전은 공식 설치 환경 문서를 기준으로 하며, 설치할 릴리즈의 요구사항도 함께 확인한다.[1]
퍼미션[편집 / 원본 편집]
설치 루트의 files 폴더에 PHP 실행 계정의 읽기·쓰기 권한이 필요하다. PHP 실행 계정과 FTP·배포 계정이 같으면 별도 조정이 필요하지 않을 수 있다. 호스팅에 따라 707 또는 777이 필요할 수 있지만 모든 서버에 일괄 적용하는 값은 아니다.[1]
설치 경로에 쓰기 권한이 있으면 설치 중 files가 자동 생성된다. 그렇지 않으면 폴더를 만들고 호스팅의 계정·권한 설정에 맞춘다. 단독 서버는 소유자와 그룹을 먼저 확인하고 필요한 범위에만 쓰기를 허용한다. 707과 777은 모두 기타 사용자에게 쓰기 권한을 주므로, 707을 다른 사용자의 쓰기를 차단하는 설정으로 해석하지 않는다. 자세한 내용은 설치 문서를 참고한다.
PHP[편집 / 원본 편집]
버전[편집 / 원본 편집]
아래 최소 버전은 실행 가능 기준이며 보안 업데이트 지원을 뜻하지 않는다. 서버 구성 시 PHP 공식 지원 기간과 사용하는 확장 기능의 호환성을 함께 확인한다.
라이믹스 설치에는 PHP 7.4 이상이 필요하며, PHP 8.2 이상을 권장합니다.[1]
PHP 7.2 이상에서의 문제[편집 / 원본 편집]
PHP 7.2 이상에서는 일부 서드파티 모듈 때문에 BaseObject 오류가 발생할 수 있습니다. 기존에 사용되던 Object 클래스가 PHP 7.2부터 지원되지 않아 'Fatal error'(HTTP 500 오류)가 뜨는 경우가 생깁니다.
이 문제는 XE에서도 공통적으로 나타나는 현상으로, XE 공식 공지에 따르면 Object를 BaseObject로 바꿔야 해결됩니다.손이 좀 가는 작업 에디터에서 찾아바꾸기 기능을 활용하면 편리합니다.[2]
이 문제는 오래된 서드파티 자료의 호환성 문제이다. 먼저 해당 자료의 업데이트판을 확인한다. 직접 수정해야 한다면 자료를 백업하고 오류 로그가 지목한 new Object(...)나 extends Object 등의 클래스 참조를 확인한다. 문자열·다른 이름까지 사이트 전체에서 일괄 치환하지 않는다. 파일의 행 번호는 자료 버전마다 달라질 수 있다.
필수 PHP 모듈[편집 / 원본 편집]
라이믹스 설치에 반드시 필요한 PHP 모듈은 다음과 같습니다:
curlgdiconv또는mbstringjsonopensslPDO_MySQLSimpleXMLZend OPCache
권장 PHP 모듈[편집 / 원본 편집]
설치는 필수가 아니지만 성능 개선이나 특정 기능에 유용한 모듈들입니다:
apcu(캐시로 성능 향상)exif(이미지 자동 회전)fileinfo(첨부파일 보안 검사)intl(한글 도메인 처리 효율성)zip(향후 필수로 바뀔 가능성 있음)
mod_rewrite는 PHP 확장이 아니라 Apache 모듈이다. Apache의 짧은주소 사용에 권장하며, nginx는 별도 rewrite 설정을 적용한다.
php.ini 설정[편집 / 원본 편집]
upload_max_filesize<post_max_size<memory_limit순으로 설정값이 커야 합니다.[3]session.auto_start는 반드시 꺼져 있어야 합니다:
session.auto_start = off
memory_limit은 최소 128M가 필요하며 대용량 이미지 처리는 256M 이상이 필요할 수 있다.
웹에서 실행하는 PHP와 CLI의 버전·확장·설정 파일은 서로 다를 수 있다. 관리자 설치 환경과 CLI 스크립트를 각각 사용하는 환경에서 확인한다.
MySQL/MariaDB[편집 / 원본 편집]
MySQL은 5.7 이상, MariaDB는 10.6 이상이 필요합니다.[1]
과거 공식 문서에서는 MariaDB 10.1 이상을 권장했으나, 현재 기준은 10.6 이상으로 상향되었습니다. 스토리지 엔진은 InnoDB, 문자 인코딩은 utf8mb4를 사용해야 4바이트 문자(이모지 등)를 저장할 수 있습니다.
각주[편집 / 원본 편집]
- ↑ 1.0 1.1 1.2 1.3 설치 환경 - 라이믹스 매뉴얼
- ↑ 단, 'new Object'나 'extends Object'처럼 앞에 다른 단어가 붙은 경우만 변경해야 함. 기진곰님 댓글 참고
- ↑ 대용량 업로드 지원 때문에 업로드 용량이 10MB 이상이면 제한이 거의 없음.
같이 보기[편집 / 원본 편집]
| 라이믹스 · 설치·운영·개발 매뉴얼 둘러보기 | |
|---|---|
| 설치·이전 | 설치 환경 · 설치 · 업데이트 · XE에서 이전 · 호환성 점검 · nginx · 도메인 변경 |
| 운영 | 백업·복원 · 업로드·서버 진단 · 캐시·성능 · Crontab · 보안 · 릴리즈 노트 |
| 개발 | 확장 기능 제작 · 애드온 · DB 연산자 · 라우터 · 이벤트 · 개발 보안 |
| 테마·API | 테마 제작 · 템플릿 v1 · 템플릿 v2 · 프레임워크 · PHP 전역 함수 · JS 라이브러리 · JS 함수 · 레거시 JS 함수 · String 확장 |
| 기여·연동 | 이슈·PR · 코딩 규칙 · 라이선스 · IP 대역 · 시간대 · 포토스와이프 · 모바일 푸시 · 네모의 꿈 색상 |