Xdebug 구성

로컬 터미널에서 텍스트 편집기에서 .magento.app.yaml 파일을 엽니다.

runtime 섹션의 extensions에서 xdebug을(를) 추가합니다. For example:

runtime:
    extensions:
        - redis
        - xsl
        - newrelic
        - sodium
        - xdebug

.magento.app.yaml 파일에 변경 내용을 저장하고 텍스트 편집기를 종료합니다.

변경 사항을 추가, 커밋 및 푸시하여 환경을 재배포합니다.

git add .magento.app.yaml

git commit -m "add xdebug"

git push origin <environment-ID>

PhpStorm 프로젝트에서 설정 패널을 엽니다.

• macOS—PhpStorm > 설정 ​을 선택합니다.
• Windows/Linux - 파일 > 설정 ​을 선택합니다.

설정 패널에서 PHP 섹션을 확장하고 서버 ​를 클릭합니다.

서버 구성을 추가하려면 + ​을(를) 클릭하십시오. 프로젝트 이름이 맨 위에 회색으로 표시됩니다.

[선택 사항] 새 서버 구성에 대해 다음 설정을 구성합니다. PHPStorm 설명서에서 구성된 디버그 서버가 없음을 참조하십시오.

• 이름—호스트 이름과 동일하게 입력합니다. 이 값은 디버깅에 CLI를 사용하려면 Debug CLI 명령의 PHP_IDE_CONFIG 변수 값과 일치해야 합니다.
• 호스트—호스트 이름을 입력하십시오.
• 포트—443을(를) 입력하십시오.
• 디버거—Xdebug을(를) 선택합니다.

경로 매핑 사용 ​을 선택하십시오. 파일/디렉터리 창에 serverName에 대한 프로젝트의 루트가 표시됩니다.

서버의 절대 경로 열에서 편집 아이콘을 클릭하고 환경에 따라 설정을 추가합니다.

• 모든 Starter 환경 및 Pro 통합 환경의 경우 원격 경로는 /app입니다.

• Pro 스테이징 및 프로덕션 환경의 경우:

  • 프로덕션: /app/<project_code>/
  • 준비 중: /app/<project_code>_stg/

Xdebug 포트를 9000,9003(으)로 변경하거나 PHP > Debug > Xdebug > Debug Port 패널에서 9000(으)로 제한할 수 있습니다.

적용 ​을 클릭합니다.

PHPStorm 애플리케이션을 열고 화면 오른쪽 상단의 Add Configuration ​을(를) 클릭합니다.

Add new run configuration ​을(를) 클릭합니다.

PHP Remote Debug 옵션을 선택하십시오.

• 고유하지만 인식할 수 있는 이름을 입력합니다.
• Filter debug connection by IDE key** 확인란을 선택합니다.
• 이전 섹션에서 만든 서버를 선택합니다. 아직 만들지 않은 경우 지금 만들 수 있지만 설정 안내서의 해당 부분을 참조하십시오.
• IDE key(session id) 텍스트 필드에 대문자로 PHPSTORM을(를) 입력합니다. 설정의 다른 부분에서 이를 사용할 예정이므로 이 항목을 동일하게 유지하는 것이 중요합니다. 다른 문자열을 선택하는 경우 설정 및 구성 프로세스에서 다른 곳에 이 문자열을 사용해야 합니다.

Apply > OK ​을(를) 클릭합니다.

터미널을 엽니다.

SSH를 사용하여 연결을 설정하십시오.

ssh -R 9000:localhost:9000 <ssh url>

소켓이 전달되는 포트에 연결될 때마다 터미널에 표시되도록 -v(verbose) 옵션을 사용합니다.

"연결할 수 없음" 또는 "원격으로 포트를 수신 대기할 수 없음" 오류가 표시되면 포트 9000을 사용 중인 서버에 다른 활성 SSH 세션이 남아 있을 수 있습니다. 해당 연결이 사용되고 있지 않으면 연결을 종료할 수 있습니다.

SSH를 사용하여 원격 통합, 스테이징 또는 프로덕션 환경에 로그인합니다.

SSH 세션 목록 보기: who

사용자별 기존 SSH 세션을 봅니다. 자신 이외의 사용자에게 영향을 주지 않도록 주의하십시오!

• 통합: 사용자 이름이 dd2q5ct7mhgus과(와) 비슷합니다.
• 스테이징: 사용자 이름이 dd2q5ct7mhgus_stg과(와) 비슷합니다.
• 프로덕션: 사용자 이름이 dd2q5ct7mhgus과(와) 비슷합니다.

기존 세션보다 오래된 사용자 세션의 경우 pts/0과(와) 같은 의사 터미널(PTS) 값을 찾습니다.

PTS 값에 해당하는 프로세스 ID(PID)를 종료합니다.

ps aux | grep ssh
kill <PID>

샘플 응답:

dd2q5ct7mhgus        5504  0.0  0.0  82612  3664 ?      S    18:45   0:00 sshd: dd2q5ct7mhgus@pts/0

연결을 종료하려면 프로세스 ID(PID)와 함께 종료 명령을 입력합니다.

kill 3664

아직 다운로드하지 않았다면 Putty을(를) 다운로드하십시오.

퍼티 시작해요

범주 창에서 세션 ​을 클릭합니다.

다음 정보를 입력합니다.

• 호스트 이름(또는 IP 주소) 필드: 클라우드 서버의 SSH URL을(를) 입력하십시오.
• 포트 필드: 22 입력

범주 창에서 연결 > SSH > 터널 ​을 클릭합니다.

다음 정보를 입력합니다.

• Source 포트 필드: 9000 입력
• 대상 필드: 127.0.0.1:9000 입력
• 원격 클릭

추가 ​를 클릭합니다.

범주 창에서 세션 ​을 클릭합니다.

저장된 세션 필드에 이 SSH 터널의 이름을 입력하십시오.

저장 ​을 클릭합니다.

SSH 터널을 테스트하려면 로드 ​를 클릭한 다음 열기 ​를 클릭합니다.

"연결할 수 없음" 오류가 표시되면 다음을 확인하십시오.

• 모든 퍼티 설정이 올바릅니다.
• 클라우드 인프라의 개인 Adobe Commerce SSH 키가 있는 컴퓨터에서 Putty를 실행하고 있습니다.

터미널을 엽니다.

클러스터의 각 웹 노드에 대한 모든 SSH 세션을 정리합니다.

ssh USERNAME@CLUSTER.ent.magento.cloud 'rm /run/platform/USERNAME/xdebug.sock'

클러스터의 각 웹 노드에 대해 Xdebug에 대한 SSH 터널을 설정합니다.

ssh -R /run/platform/USERNAME/xdebug.sock:localhost:9000 -N USERNAME@CLUSTER.ent.magento.cloud

원격 디버깅을 사용하도록 설정합니다. 브라우저의 사이트를 방문하여 KEY이(가) xdebug_key의 값인 URL에 다음을 추가하십시오.

?XDEBUG_SESSION_START=KEY

이 단계에서는 Xdebug을(를) 트리거하기 위해 브라우저 요청을 보내는 쿠키를 설정합니다.

Xdebug (으)로 디버깅을 완료합니다.

세션을 종료할 준비가 되면 다음 명령을 사용하여 쿠키를 제거하고 브라우저를 통해 디버깅을 종료합니다. 여기서 KEY은(는) xdebug_key의 값입니다.

?XDEBUG_SESSION_STOP=KEY

CLI 명령을 사용하여 디버그하려는 서버에 SSH를 연결합니다.

다음 환경 변수를 만듭니다.

export XDEBUG_CONFIG='PHPSTORM'

export PHP_IDE_CONFIG="serverName=<name of the server that is configured in PHPSTORM>"

이 변수는 SSH 세션이 종료되면 제거됩니다.

디버깅 시작

Starter 환경 및 Pro 통합 환경에서 CLI 명령을 실행하여 디버그합니다.
다음과 같은 런타임 옵션을 추가할 수 있습니다.

php -d xdebug.profiler_enable=On -d xdebug.max_nesting_level=9999 bin/magento cache:clean

Pro Staging 및 Production 환경에서는 다음과 같이 CLI 명령을 디버깅할 때 Xdebug PHP 구성 파일의 경로를 지정해야 합니다.

php -c /etc/platform/USERNAME/php.xdebug.ini bin/magento cache:clean

확장 메뉴에서 디버그 ​를 클릭하여 사용하도록 설정합니다.

마우스 오른쪽 단추를 클릭하고 옵션 메뉴를 선택한 다음 IDE 키를 PHPSTORM(으)로 설정합니다.

브라우저에 Xdebug 클라이언트를 설치합니다. 구성 및 활성화합니다.

클라우드 서버에 대한 SSH 터널을(를) 만듭니다.

Chrome 스토어에서 Xdebug Helper 확장 기능을 설치하십시오.

다음 그림과 같이 Chrome에서 확장을 활성화합니다.

Chrome에서 Chrome 도구 모음의 녹색 도우미 아이콘을 마우스 오른쪽 단추로 클릭합니다.

팝업 메뉴에서 옵션 ​을 클릭합니다.

IDE 키 목록에서 PhpStorm ​을 클릭합니다.

저장 ​을 클릭합니다.

PhpStorm 프로젝트를 엽니다.

위쪽 탐색 모음에서 수신 시작 아이콘을 클릭합니다.

탐색 모음이 표시되지 않으면 보기 > 탐색 모음 ​을 클릭하세요.

PhpStorm 탐색 창에서 테스트할 PHP 파일을 두 번 클릭합니다.

SSH를 사용하여 원격 환경에 로그인합니다.

파일을 압축합니다.

tar -czf /tmp/<file-name>.tgz <directory list>

예를 들어 vendor 디렉터리만 압축하려면 다음을 수행합니다.

tar -czf /tmp/vendor.tgz vendor

로컬 환경에서 PhpStorm을 사용하여 파일을 압축합니다.

cd <phpstorm project root dir>

rsync <SSH-URL>:/tmp/<file-name>.tgz .

tar xzf <file-name>.tgz