라이믹스/매뉴얼/설치 환경 편집하기

== 개요 ==
[[라이믹스]]를 설치하고 운영하기 위해 필요한 시스템 요구사항을 정리한 문서입니다. 기본적으로 웹 서버(예: Apache, Nginx) 같은 필수 요소는 당연히 있어야 하니 여기선 생략했습니다.<ref>웹 서버가 없으면 PHP 파일을 실행할 수 없기 때문.</ref>

== 퍼미션 ==
라이믹스 설치 루트 폴더 안의 '''files''' 폴더 퍼미션은 707 또는 777로 설정해야 합니다. 설치 경로에 쓰기 권한이 있으면 설치 중 자동으로 files 폴더가 생성되지만, 권한이 없으면 직접 폴더를 만들고 퍼미션을 조정해야 합니다.

== PHP ==
=== 버전 ===
[[라이믹스]] 설치에는 PHP 7.4 이상이 필요합니다.

==== PHP 7.2 이상에서의 문제 ====
PHP 7.2 이상에서는 일부 서드파티 모듈 때문에 '''BaseObject''' 오류가 발생할 수 있습니다. 기존에 사용되던 <code>Object</code> 클래스가 PHP 7.2부터 지원되지 않아 'Fatal error'(HTTP 500 오류)가 뜨는 경우가 생깁니다.  
이 문제는 [[XpressEngine|XE]]에서도 공통적으로 나타나는 현상으로, [https://www.xpressengine.com/devlog/23249915 XE 공식 공지]에 따르면 <code>Object</code>를 <code>BaseObject</code>로 바꿔야 해결됩니다.<del>손이 좀 가는 작업</del> 에디터에서 찾아바꾸기 기능을 활용하면 편리합니다.<ref>단, 'new Object'나 'extends Object'처럼 앞에 다른 단어가 붙은 경우만 변경해야 함. [https://xetown.com/questions/1164680#comment_1164942 기진곰님 댓글 참고]</ref>

리눅스 환경이라면 아래 명령어로 쉽게 일괄 변경 가능합니다.
<syntaxhighlight lang="console">
root@gaon:/var/www/html/# find ./ -name "*.php" -exec sed -i 's/return\snew\sObject/return new BaseObject/g' {} \;
root@gaon:/var/www/html/# find ./ -name "*.php" -exec sed -i 's/extends\sObject/extends BaseObject/g' {} \;
</syntaxhighlight>
다만, [[XpressEngine/모듈/타임라인|타임라인]] 모듈처럼 예외적인 경우는 명령어가 적용되지 않을 수 있으니, 이런 경우엔 직접 수정해야 합니다. 타임라인 모듈이라면 <code>./modules/timeline/timeline.admin.model.php</code> 파일의 44번째 줄에서 <code>Object</code>를 <code>BaseObject</code>로 바꾸면 됩니다.

=== 필수 PHP 모듈 ===
라이믹스 설치에 반드시 필요한 PHP 모듈은 다음과 같습니다:
* <code>curl</code>
* <code>gd</code>
* <code>iconv</code> 또는 <code>mbstring</code>
* <code>json</code>
* <code>openssl</code>
* <code>PDO_MySQL</code>
* <code>SimpleXML</code>
* <code>Zend OPCache</code>

=== 권장 PHP 모듈 ===
설치는 필수가 아니지만 성능 개선이나 특정 기능에 유용한 모듈들입니다:
* <code>apcu</code> (캐시로 성능 향상)
* <code>exif</code> (이미지 자동 회전)
* <code>fileinfo</code> (첨부파일 보안 검사)
* <code>intl</code> (한글 도메인 처리 효율성)
* <code>zip</code> (향후 필수로 바뀔 가능성 있음)
* <code>mod_rewrite</code> (Apache에서 짧은 주소 사용 시, 선택 사항)

=== php.ini 설정 ===
* '''<code>upload_max_filesize</code> < <code>post_max_size</code> < <code>memory_limit</code>''' 순으로 설정값이 커야 합니다.<ref>[[라이믹스/XE와의 차이점#대용량 업로드|대용량 업로드]] 지원 때문에 업로드 용량이 10MB 이상이면 제한이 거의 없음.</ref>
* <code>session.auto_start</code>는 반드시 꺼져 있어야 합니다:
<syntaxhighlight lang="ini">
session.auto_start = off
</syntaxhighlight>
* <code>memory_limit</code>은 최소 128M 이상으로 설정되어 있어야 합니다.

== MySQL/MariaDB ==
MySQL은 5.7 이상 버전을 사용해야 하며, 개발진은 MariaDB 10.1 이상을 권장합니다.

== 각주 ==
<references />

<!-- 분류 -->
[[분류:라이믹스]]