Apache

Adobe Commerce은 Apache 2.4.x를 지원합니다.

Apache 필수 지시문

  1. URL에 문제를 일으킬 수 있는 인코딩된 슬래시를 디코딩하지 않도록 서버 구성(전역) 또는 가상 호스트 구성에서 AllowEncodedSlashes을(를) 설정하십시오. 예를 들어 API를 통해 SKU에서 슬래시가 있는 제품을 검색할 때 변환하지 않으려고 합니다. 샘플 블록이 완료되지 않았으며 다른 지시문이 필요합니다.

    code language-conf
    <VirtualHost *:443>
      # Allow encoded slashes
      AllowEncodedSlashes NoDecode
    </VirtualHost>
    

Apache rewrites 및 htaccess

이 항목에서는 Apache 2.4 재작성을 활성화하고 분산 구성 파일 .htaccess에 대한 설정을 지정하는 방법에 대해 설명합니다.

Adobe Commerce은 서버 재작성 및 .htaccess을(를) 사용하여 Apache에 디렉터리 수준 지침을 제공합니다. 이 항목의 다른 모든 섹션에도 다음 지침이 포함되어 있습니다.

이 섹션을 사용하여 Apache 2.4 재작성을 활성화하고 분산 구성 파일 .htaccess에 대한 설정을 지정하십시오.

Adobe Commerce은 서버 재작성 및 .htaccess을(를) 사용하여 Apache에 디렉터리 수준 지침을 제공합니다.

NOTE
이러한 설정을 활성화하지 않으면 일반적으로 상점 또는 관리자에 스타일이 표시되지 않습니다.
  1. Apache 재작성 모듈 활성화:

    code language-bash
    a2enmod rewrite
    
  2. 응용 프로그램에서 배포된 .htaccess 구성 파일을 사용할 수 있도록 하려면 Apache 2.4 설명서의 지침을 참조하십시오.

    note tip
    TIP
    Apache 2.4에서 서버의 기본 사이트 구성 파일은 /etc/apache2/sites-available/000-default.conf입니다.

    예를 들어 000-default.conf의 끝에 다음을 추가할 수 있습니다.

    code language-none
    <Directory "/var/www/html">
        AllowOverride All
    </Directory>
    
    note note
    NOTE
    경우에 따라 추가 매개 변수가 필요할 수 있습니다. 자세한 내용은 Apache 2.4 설명서를 참조하십시오.
  3. Apache 설정을 변경한 경우 Apache를 다시 시작합니다.

    code language-bash
    service apache2 restart
    
    note note
    NOTE
    • 이전 Apache 버전에서 업그레이드한 경우 먼저 000-default.conf에서 <Directory "/var/www/html"> 또는 <Directory "/var/www">을(를) 찾습니다.
    • Adobe Commerce 소프트웨어를 설치할 디렉터리에 대한 지시문에서 AllowOverride 값을 변경해야 합니다. 예를 들어 웹 서버 docroot에 설치하려면 <Directory /var/www>에서 지시문을 편집하십시오.
NOTE
이러한 설정을 활성화하지 않으면 일반적으로 상점 또는 관리자에 스타일이 표시되지 않습니다.

Apache 필수 모듈

Adobe Commerce을 사용하려면 다음 Apache 모듈이 설치되어 있어야 합니다.

Apache 버전 확인

현재 실행 중인 Apache 버전을 확인하려면 다음을 입력합니다.

apache2 -v

결과는 다음과 유사하게 표시됩니다.

Server version: Apache/2.4.04 (Ubuntu)
Server built: Jul 22 2020 14:35:32

Ubuntu에서 Apache 설치 또는 업그레이드

다음 섹션에서는 Apache 설치 또는 업그레이드 방법에 대해 설명합니다.

  • Apache 설치
  • PHP 7.4를 사용하려면 Ubuntu에서 Apache 2.4로 업그레이드하십시오.

Ubuntu에 Apache 설치

Apache의 기본 버전을 설치하려면

  1. Apache 설치

    code language-bash
    apt-get -y install apache2
    
  2. 설치를 확인합니다.

    code language-bash
    apache2 -v
    

    결과는 다음과 유사하게 표시됩니다.

    code language-none
    Server version: Apache/2.4.18 (Ubuntu)
    Server built: 2020-04-15T18:00:57
    
  3. 다시 쓰기 및 .htaccess을(를) 사용하도록 설정합니다.

우분투에서 Apache 업그레이드

Apache 2.4로 업그레이드하려면 다음을 수행하십시오.

  1. Apache 2.4가 있는 ppa:ondrej 저장소 추가:

    code language-bash
    apt-get -y update
    
    code language-bash
    apt-add-repository ppa:ondrej/apache2
    
    code language-bash
    apt-get -y update
    
  2. Apache 2.4 설치:

    code language-bash
    apt-get install -y apache2
    
    note note
    NOTE
    충족되지 않는 종속성으로 인해 'apt-get install' 명령이 실패한 경우 https://askubuntu.com/과(와) 같은 리소스를 참조하십시오.
  3. 설치를 확인합니다.

    code language-bash
    apache2 -v
    

    다음과 유사한 메시지가 표시되어야 합니다.

    code language-none
    Server version: Apache/2.4.10 (Ubuntu)
    Server built: Jul 22 2020 22:46:25
    
  4. 다시 쓰기 및 .htaccess을(를) 사용하도록 설정합니다.

CentOS에 Apache 설치

Adobe Commerce은 Apache 서버 재쓰기가 필요합니다. 또한 응용 프로그램에서 재작성 규칙을 지정하는 데 사용하는 .htaccess에서 사용할 수 있는 지시문 형식을 지정해야 합니다.

Apache 설치 및 구성은 기본적으로 소프트웨어를 설치하고, 다시 쓰기를 활성화하고, .htaccess 지시문을 지정하는 3단계 프로세스입니다.

Apache 설치

  1. 아직 설치하지 않은 경우 Apache 2.4를 설치합니다.

    code language-bash
    yum -y install httpd
    
  2. 설치 확인:

    code language-bash
    httpd -v
    

    설치가 성공했는지 확인하는 다음 디스플레이와 유사한 메시지:

    code language-none
    Server version: Apache/2.4.40 (Unix)
    Server built: Oct 16 2020 14:48:21
    
  3. 다음 섹션을 계속합니다.

    note note
    NOTE
    Apache 2.4가 기본적으로 CentOS와 함께 제공되더라도 다음 섹션을 참조하여 구성하십시오.

CentOS용 rewrites 및 .htaccess 활성화

  1. 편집할 /etc/httpd/conf/httpd.conf 파일 열기:

    code language-bash
    vim /etc/httpd/conf/httpd.conf`
    
  2. 다음으로 시작하는 블록을 찾습니다.

    code language-conf
    <Directory "/var/www/html">
    
  3. AllowOverride의 값을 All(으)로 변경합니다.

    For example,

    code language-conf
    <Directory "/var/www/">
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Order allow,deny
      Allow from all
    </Directory>
    
    note note
    NOTE
    Order에 대한 이전 값이 모든 경우에 작동하지 않을 수 있습니다. 자세한 내용은 Apache 설명서(2.4)를 참조하십시오.
  4. 파일을 저장하고 텍스트 편집기를 종료합니다.

  5. Apache 설정을 적용하려면 Apache를 다시 시작합니다.

    code language-bash
    service apache2 restart
    
NOTE
이러한 설정을 활성화하지 않으면 일반적으로 상점 또는 관리자에 스타일이 표시되지 않습니다.

Ubuntu에 대한 재작성 및 .htaccess 활성화

  1. 편집할 /etc/apache2/sites-available/default 파일 열기:

    code language-bash
    vim /etc/apache2/sites-available/default
    
  2. 다음으로 시작하는 블록을 찾습니다.

    <Directory "/var/www/html">

  3. AllowOverride의 값을 All(으)로 변경합니다.

    For example:

    code language-conf
    <Directory "/var/www/html">
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Order allow,deny
      Allow from all
    </Directory>
    
  4. 파일을 저장하고 텍스트 편집기를 종료합니다.

  5. mod_rewrite 모듈을 사용하도록 Apache 구성:

    code language-bash
    cd /etc/apache2/mods-enabled
    
    code language-bash
    ln -s ../mods-available/rewrite.load
    
  6. 변경 사항을 적용하려면 Apache를 다시 시작하십시오.

    code language-bash
    service apache2 restart
    

403(사용할 수 없음) 오류 해결

사이트에 액세스하려고 할 때 403 금지된 오류가 발생하는 경우 Apache 구성 또는 가상 호스트 구성을 업데이트하여 사이트 방문자를 사용할 수 있도록 할 수 있습니다.

Apache 2.4에 대해 403 금지된 오류 해결

웹 사이트 방문자가 사이트에 액세스할 수 있도록 하려면 지시문 필요 중 하나를 사용하십시오.

For example:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Order에 대한 이전 값이 모든 경우에 작동하지 않을 수 있습니다. 자세한 내용은 Apache 설명서를 참조하십시오.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995