php-redis 확장 업데이트 방법 (Shopware 업데이트 중에 필요할 수 있는 이유)

Source: Dev.to

왜 Shopware 업데이트 중 php‑redis 확장을 업데이트해야 할 수도 있는가

최신 Shopware 6.7.7.0 버전에는 Symfony 7.4 LTS로의 업그레이드가 포함되어 있습니다
(release notes).

• Symfony 7.3은 2026년 1월에 공식 지원이 종료되었습니다
  (Symfony releases calendar).
• Shopware 6.6 LTS도 다음 릴리스에서 동일한 Symfony 업데이트를 받을 예정입니다.

Symfony 7.3 → 7.4 로의 전환은 마이너 버전 상승이며 Symfony 자체에 파괴적인 변화는 없지만, Symfony 팀은 업그레이드의 일환으로 php‑redis 확장의 최소 요구 버전을 6.1로 상향했습니다.

만약 아직 오래된 php‑redis 버전을 사용 중이라면(예: Ubuntu 24.04 LTS에 포함된 php‑redis 5.3), Shopware를 성공적으로 업그레이드하기 전에 해당 확장을 업데이트해야 합니다.

현재 실행 중인 php‑redis 버전을 어떻게 확인할 수 있나요?

다음 명령을 실행합니다:

php --ri redis | head -1

출력에 버전 6.1 이상이 표시되면 Shopware 업그레이드를 진행할 준비가 된 것입니다.
구버전이 표시되면 먼저 확장을 업데이트해야 합니다.

Note: Symfony는 이제 오래된 php‑redis 버전에 대해 Composer 충돌을 추가하므로, 확장이 구버전이면 Shopware 업그레이드가 Composer 오류와 함께 실패합니다.

지금 php‑redis 확장을 업데이트해야 할까요?

• Shopware를 Symfony 7.4를 요구하는 버전(따라서 php‑redis ≥ 6.1)으로 업그레이드할 계획이 있을 때만 php‑redis를 업그레이드하십시오.
• 오래된 Shopware 버전을 유지하고 있는 운영 중인 프로덕션 환경에서 확장을 업데이트해도 이점이 없으며, 오히려 호환성 문제가 발생할 수 있습니다(예: 최신 php‑redis와 Shopware 6.5가 동작하지 않을 수 있음).

요약하면, 다가오는 Shopware 업그레이드에 필요할 경우에만 업데이트하십시오.

Source: …

Docker에서 php‑redis 확장 모듈 업데이트 방법

1. Docker PHP 확장 설치 스크립트를 이미지에 추가하고 실행 권한을 부여합니다:

   ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
   RUN chmod +x /usr/local/bin/install-php-extensions

2. php‑redis 확장을 설치(또는 업그레이드)합니다:

   RUN install-php-extensions redis

   기본적으로 최신 안정 버전이 설치됩니다.

3. 특정 버전을 고정합니다 (특정 릴리스를 사용해야 할 경우):

   -RUN install-php-extensions redis-6.0
   +RUN install-php-extensions redis-6.3

4. 공식 Shopware Docker 이미지 (shopware/docker)를 사용하는 경우, 확장은 이미 최신 상태로 유지됩니다. 최신 이미지 태그를 풀(pull)하기만 하면 됩니다.

Ubuntu에서 php‑redis 확장 업데이트 방법

기본 Ubuntu 저장소에서 설치

sudo apt install -y php-redis

저장소에 있는 버전이 너무 오래된 경우(예: Ubuntu 24.04에서는 5.3 제공), 아래 단계로 진행하세요.

ondrej/php PPA(새로운 PHP 패키지를 위한 신뢰할 수 있는 소스)에서 설치

sudo add-apt-repository ppa:ondrej/php   # 프롬프트가 나오면 Enter 키를 누르세요
sudo apt update
sudo apt install -y php-redis

이 명령은 PPA에서 최신 php‑redis 버전을 가져옵니다.

확장 프로그램을 로컬에 설치하는 방법 (with PIE)

PIE 은 최신 패키지를 Packagist에서 가져와 기존 PECL 워크플로를 대체하는 현대적인 PHP 확장 설치 도구입니다.

PIE 설치

curl -fL --output /tmp/pie.phar https://github.com/php/pie/releases/latest/download/pie.phar \
  && gh attestation verify --owner php /tmp/pie.phar \
  && sudo mv /tmp/pie.phar /usr/local/bin/pie \
  && sudo chmod +x /usr/local/bin/pie

PIE로 php‑redis 확장 프로그램 설치(또는 업그레이드)

pie install redis

PIE는 자동으로 호환되는 최신 버전의 확장 프로그램을 가져옵니다.

이 가이드는 최신 php‑redis 확장 프로그램이 필요한 Shopware 업그레이드 시 문제 해결을 위한 참고용으로 작성되었습니다.

PIE로 php-redis 확장 설치

PIE가 이미 설치되어 있다면, 다음 명령을 실행하여 php-redis 확장을 추가할 수 있습니다:

pie install phpredis/phpredis

PECL을 사용하여 로컬에 확장 설치하기

PECL은 PHP용 전통적인 확장 설치 프로그램입니다. 설정 과정이 PIE보다 복잡하므로, 이미 PECL이 구성되어 있지 않은 경우 일반적으로 권장되지 않습니다.

PECL을 사용할 수 있다면, 최신 Redis 확장을 다음과 같이 설치하십시오:

pecl install redis