라이믹스/매뉴얼/설치 환경: 두 판 사이의 차이

2025년 6월 13일 (금) 10:57 기준 최신판

개요[편집 / 원본 편집]

라이믹스를 설치하고 운영하기 위해 필요한 시스템 요구사항을 정리한 문서입니다. 기본적으로 웹 서버(예: Apache, Nginx) 같은 필수 요소는 당연히 있어야 하니 여기선 생략했습니다.^[1]

퍼미션[편집 / 원본 편집]

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

PHP 7.2 이상에서는 일부 서드파티 모듈 때문에 BaseObject 오류가 발생할 수 있습니다. 기존에 사용되던 Object 클래스가 PHP 7.2부터 지원되지 않아 'Fatal error'(HTTP 500 오류)가 뜨는 경우가 생깁니다. 이 문제는 XE에서도 공통적으로 나타나는 현상으로, XE 공식 공지에 따르면 Object를 BaseObject로 바꿔야 해결됩니다.~~손이 좀 가는 작업~~ 에디터에서 찾아바꾸기 기능을 활용하면 편리합니다.^[2]

리눅스 환경이라면 아래 명령어로 쉽게 일괄 변경 가능합니다.

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' {} \;

다만, 타임라인 모듈처럼 예외적인 경우는 명령어가 적용되지 않을 수 있으니, 이런 경우엔 직접 수정해야 합니다. 타임라인 모듈이라면 ./modules/timeline/timeline.admin.model.php 파일의 44번째 줄에서 Object를 BaseObject로 바꾸면 됩니다.

필수 PHP 모듈[편집 / 원본 편집]

라이믹스 설치에 반드시 필요한 PHP 모듈은 다음과 같습니다:

curl
gd
iconv 또는 mbstring
json
openssl
PDO_MySQL
SimpleXML
Zend OPCache

권장 PHP 모듈[편집 / 원본 편집]

설치는 필수가 아니지만 성능 개선이나 특정 기능에 유용한 모듈들입니다:

apcu (캐시로 성능 향상)
exif (이미지 자동 회전)
fileinfo (첨부파일 보안 검사)
intl (한글 도메인 처리 효율성)
zip (향후 필수로 바뀔 가능성 있음)
mod_rewrite (Apache에서 짧은 주소 사용 시, 선택 사항)

php.ini 설정[편집 / 원본 편집]

upload_max_filesize < post_max_size < memory_limit 순으로 설정값이 커야 합니다.^[3]
session.auto_start는 반드시 꺼져 있어야 합니다:

session.auto_start = off

memory_limit은 최소 128M 이상으로 설정되어 있어야 합니다.

MySQL/MariaDB[편집 / 원본 편집]

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

각주[편집 / 원본 편집]

↑ 웹 서버가 없으면 PHP 파일을 실행할 수 없기 때문.
↑ 단, 'new Object'나 'extends Object'처럼 앞에 다른 단어가 붙은 경우만 변경해야 함. 기진곰님 댓글 참고
↑ 대용량 업로드 지원 때문에 업로드 용량이 10MB 이상이면 제한이 거의 없음.

[1] 웹 서버가 없으면 PHP 파일을 실행할 수 없기 때문.

[2] 단, 'new Object'나 'extends Object'처럼 앞에 다른 단어가 붙은 경우만 변경해야 함. 기진곰님 댓글 참고

[3] 대용량 업로드 지원 때문에 업로드 용량이 10MB 이상이면 제한이 거의 없음.

[1]

[2]

[3]

@@ 1번째 줄: / 1번째 줄: @@
-==라이믹스?==
+== 개요 ==
-* [[라이믹스]]에 대해 알아보고 싶다면 [[라이믹스]] 문서를 참고하자.
+[[라이믹스]]를 설치하고 운영하기 위해 필요한 시스템 요구사항을 정리한 문서입니다. 기본적으로 웹 서버(예: Apache, Nginx) 같은 필수 요소는 당연히 있어야 하니 여기선 생략했습니다.<ref>웹 서버가 없으면 PHP 파일을 실행할 수 없기 때문.</ref>
-==요구사양==
+== 퍼미션 ==
-* 라이믹스에서 요구하는 사양에 대해 알아보자.
+라이믹스 설치 루트 폴더 안의 '''files''' 폴더 퍼미션은 707 또는 777로 설정해야 합니다. 설치 경로에 쓰기 권한이 있으면 설치 중 자동으로 files 폴더가 생성되지만, 권한이 없으면 직접 폴더를 만들고 퍼미션을 조정해야 합니다.
-* 이때 진짜 기본적인 것(웹 서버)에 대해서는 작성하지 않았습니다.<ref>웹 서버 프로그램이 없으면 php 파일 등을 처리 할 수 없기 때문이다.</ref>
-==퍼미션==
+== PHP ==
-라이믹스 설치 루트 폴더에 있는 files 폴더의 퍼미션이 707이나 777이어야 한다. 설치 경로에 쓰기 권한이 이미 있는 경우, 설치 과정에서 files 폴더를 자동으로 생성한다. 설치 경로에 쓰기 권한이 없는 경우에는 수동으로 files 폴더를 생성/퍼미션 조정을 해야 한다.
+=== 버전 ===
+[[라이믹스]] 설치에는 PHP 7.4 이상이 필요합니다.
-==PHP==
+==== PHP 7.2 이상에서의 문제 ====
-[[라이믹스]]를 사용하려면, 7.0 이상이 설치 되어 있어야 합니다. PHP 5.x 버전대는 설치가 되지 않도록 설정되었으며, 강제로 설치를 진행하여도 각종 오류가 난무하여 사용 할 수 없습니다.<ref>PHP 7 문법이 적용 되었기 때문이다.</ref>
+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>
-===7.2 이상===
+리눅스 환경이라면 아래 명령어로 쉽게 일괄 변경 가능합니다.
-PHP 7.2 이상에서 일부 서드파티들로 인해 오류가 발생 할 수 있다. '''BaseObject''' 오류가 발생하는데, PHP 7.2 이상은 원래 사용하던 클래스인 '''Object'''를 사용하지 못해 'Fatal error'가 발생한다.(HTTP 500에러 발생)
+<syntaxhighlight lang="console">
-이 문제는 [[XpressEngine|XE]]에서도 나타나는 현상이다. [https://www.xpressengine.com/devlog/23249915 XE 공식 홈페이지 공지사항] 그렇기 때문에 'Object'를 'BaseObject'로 바꿔줘야 한다.<del>노가다</del> 에디터에서 찾아 바꾸기를 통해 바꾸면 그나마 쉽다.<ref>new Object나 extend Object와 같이
-앞에 다른 단어가 있는 Object만 변경해야 한다. [https://xetown.com/questions/1164680#comment_1164942 xetown Object 변경 관련 기진곰님 댓글]</ref>
-리눅스에서 라이믹스(XE)가 설치 된 폴더로 이동 후, 아래와 같이 입력하면 쉽게 바뀐다. 참고하자.<ref>[https://xetown.com/questions/1082527#comment_1082641 XETOWN php 7.2 업그레이드를 위한 return new object > return new BaseObject 일괄변경하기]</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>
-명령어를 사용하더라도 [[XpressEngine/모듈/타임라인|타임라인]] 모듈과 같은 특이한(?) 것들은 적용되지 않는다. 따라서 직접 수정을 해야 하며, 타임라인 모듈 같은 경우, 타임라인 폴더(./modules/timeline)로 들어가 timeline.admin.model.php의 44번째 줄에 있는 Object를 BaseObject로 바꿔주자.
+=== 권장 PHP 모듈 ===
+설치는 필수가 아니지만 성능 개선이나 특정 기능에 유용한 모듈들입니다:
-===PHP 모듈===
+* <code>apcu</code> (캐시로 성능 향상)
-[[라이믹스]]를 설치하기 위해 필수적으로 설치되어야 하는 PHP 모듈은 다음과 같습니다.
+* <code>exif</code> (이미지 자동 회전)
-* curl
+* <code>fileinfo</code> (첨부파일 보안 검사)
-* gd
+* <code>intl</code> (한글 도메인 처리 효율성)
-* iconv 또는 mbstring
+* <code>zip</code> (향후 필수로 바뀔 가능성 있음)
-* json
+* <code>mod_rewrite</code> (Apache에서 짧은 주소 사용 시, 선택 사항)
-* mcrypt 또는 openssl
-* PDO
-* SimpleXML
-* Zend OPCache
-아래의 모듈들은 권장 모듈입니다.
-* apcu
-:; 캐시 사용을 통해 성능 향상 가능
-* exif
-:; 이미지 자동 회전 기능에 필요
-* fileinfo
-:; 첨부파일 보안 검사에 필요
-* intl
-:; 한글도메인 사용시 성능 향상 효과 있음
-* zip
-:; 추후 필수 모듈로 지정될 가능성 있음
-* mod_rewrite
-:; 아파치, 선택사항
-===php.ini 설정===
-'''upload_max_filesize''' 설정치보다 '''post_max_size'''가 커야 합니다. 또한 '''post_max_size''' 설정치보다 '''memory_limit'''이 커야 합니다.<ref>upload_max_filesize < post_max_size < memory_limit</ref><br/>
-→ 라이믹스는 [[라이믹스/XE와의 차이점#대용량 업로드|대용량 업로드]]를 지원하기 때문에, 업로드 용량이 10MB 이상이면 사실상 업로드에 제약을 받지 않습니다.
-'''session.auto_start'''이 아래와 같이 off로 설정 되어야 합니다.
+=== 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 이상을 권장합니다.
-==Mysql/MariaDB==
+== 각주 ==
-Mysql은 5.0.7 이상의 버전을 사용해야 합니다. [[라이믹스]] 개발진들은 MariaDB를 권장한다고 한다.
+<references />
-==각주==
+<!-- 분류 -->
+[[분류:라이믹스]]