PHP에서 date_create_immutable 함수의 버전 호환성 문제를 해결하는 방법은 무엇입니까?

gitbox 2025-09-20

PHP에서 date_create_immutable 함수는 불변의 날짜 시간 객체를 만드는 데 사용됩니다. date_create 함수와 달리 date_create_immutable은 datetimeimmutable 객체를 반환합니다. 이런 종류의 객체는 원래 객체를 변경하지 않고 수정 될 때마다 새 객체를 반환합니다. 이 불변성 기능은 많은 경우 더 안전하고 예측 가능한 행동을 제공 할 수 있습니다.

그러나 date_create_immutable 기능을 사용하면 버전 호환성 문제가 발생할 수 있습니다. 구체적으로, date_create_immutable 함수는 PHP 버전 5.5 이상에서만 소개되었습니다. 따라서이 기능을 사용할 때 사용 된 PHP 버전 이이 기능에 의해 충분히 지원되도록해야합니다. 그렇지 않으면 오류가 발생합니다.

1. PHP 버전을 확인하십시오

먼저 현재 PHP 버전을 확인하십시오. 사용 된 PHP 버전이 5.5 미만인 경우 date_create_immutable 함수를 직접 사용할 수 없습니다. 이 경우 몇 가지 옵션이 있습니다.

PHP 버전 업그레이드

가장 직접적인 방법은 PHP를 date_create_immutable을 지원하는 버전으로 업그레이드하는 것입니다. 명령에 따라 현재 PHP 버전을 확인할 수 있습니다.

 <span><span>php -v
</span></span>

PHP 버전이 낮은 경우 해당 방법을 사용하여 운영 체제에 따라 업그레이드 할 수 있습니다. 예를 들어 Ubuntu 시스템에서 다음 명령으로 최신 PHP 버전을 설치할 수 있습니다.

 <span><span>sudo apt-get install php7.4
</span></span>

업그레이드 후 웹 서버 (예 : Apache 또는 Nginx)를 다시 시작하여 변경 사항이 적용됩니다.

대안 사용

어떤 이유로 PHP 버전을 업그레이드 할 수없는 경우 Date_create 기능을 대안으로 사용하고 DateTime 객체를 만들고 복제를 통해 불변성을 달성 할 수 있습니다. 다음은 샘플 코드입니다.

 <span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title function_ invoke__">date_create</span></span><span>(</span><span><span class="hljs-string">'2025-06-26'</span></span><span>);
</span><span><span class="hljs-variable">$dateImmutable</span></span><span> = </span><span><span class="hljs-keyword">clone</span></span><span> </span><span><span class="hljs-variable">$date</span></span><span>;  </span><span><span class="hljs-comment">// 불변의 복제DateTime물체</span></span><span>
</span></span>

이런 식으로 DateTimeImutable 의 기능이 완전히 구현되지는 않지만 불변의 물체의 동작을 모방 할 수 있습니다.

2. 조건 DATE_CREATE_IMMUTABLE을 사용하십시오

응용 프로그램이 다른 버전의 PHP와 호환되어야하는 경우 조건부 판단으로 date_create_immutable 기능을 사용할지 여부를 결정할 수 있습니다. 예를 들어:

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">function_exists</span></span><span>(</span><span><span class="hljs-string">'date_create_immutable'</span></span><span>)) {
    </span><span><span class="hljs-comment">// 사용date_create_immutable</span></span><span>
    </span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title function_ invoke__">date_create_immutable</span></span><span>(</span><span><span class="hljs-string">'2025-06-26'</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-comment">// 사용兼容方案，좋다date_create</span></span><span>
    </span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title function_ invoke__">date_create</span></span><span>(</span><span><span class="hljs-string">'2025-06-26'</span></span><span>);
    </span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-keyword">clone</span></span><span> </span><span><span class="hljs-variable">$date</span></span><span>;
}
</span></span>

이러한 방식으로 날짜 시간 기능이 오류를 일으키지 않고 다른 PHP 버전에서 정상적으로 사용되도록 할 수 있습니다.

3. Polyfill 패키지를 사용하십시오

또 다른 솔루션은 PolyFill (호환성 패치) 패키지를 사용하는 것입니다. 이 패키지는 일반적으로 낮은 버전의 PHP에서 새로운 기능을 모방합니다. 작곡가를 사용하여 관련 폴리 플릴 패키지를 설치할 수 있습니다. 설치 프로세스는 다음과 같습니다.

 <span><span>composer require symfony/polyfill-php56
</span></span>

설치 후 PolyFill 패키지는 Date_Create_immutable을 지원하지 않는 PHP 버전에 대한 대체 구현을 제공하여 코드 호환성을 보장합니다.

4. 사용자 정의 구현

타사 패키지에 의존하거나 PHP 버전을 업그레이드하지 않으려면 DateTimeImutable 유사 기능을 수동으로 구현하는 것을 고려할 수도 있습니다. 간단한 사용자 정의 구현은 다음과 같습니다.

 <span><span><span class="hljs-class"><span class="hljs-keyword">class</span></span></span><span> </span><span><span class="hljs-title">MyDateTimeImmutable</span></span><span> </span><span><span class="hljs-keyword">extends</span></span><span> </span><span><span class="hljs-title">DateTime</span></span><span>
{
    </span><span><span class="hljs-keyword">public</span></span><span> </span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">modify</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$modify</span></span></span><span>)
    {
        </span><span><span class="hljs-variable">$clone</span></span><span> = </span><span><span class="hljs-keyword">clone</span></span><span> </span><span><span class="hljs-variable language_">$this</span></span><span>;
        </span><span><span class="hljs-variable">$clone</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">modify</span></span><span>(</span><span><span class="hljs-variable">$modify</span></span><span>);
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-variable">$clone</span></span><span>;
    }

    </span><span><span class="hljs-keyword">public</span></span><span> </span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">setDate</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$year</span></span></span><span>, </span><span><span class="hljs-variable">$month</span></span><span>, </span><span><span class="hljs-variable">$day</span></span><span>)
    {
        </span><span><span class="hljs-variable">$clone</span></span><span> = </span><span><span class="hljs-keyword">clone</span></span><span> </span><span><span class="hljs-variable language_">$this</span></span><span>;
        </span><span><span class="hljs-variable">$clone</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">setDate</span></span><span>(</span><span><span class="hljs-variable">$year</span></span><span>, </span><span><span class="hljs-variable">$month</span></span><span>, </span><span><span class="hljs-variable">$day</span></span><span>);
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-variable">$clone</span></span><span>;
    }

    </span><span><span class="hljs-comment">// 다른 유사한 방법...</span></span><span>
}

</span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">MyDateTimeImmutable</span></span><span>(</span><span><span class="hljs-string">'2025-06-26'</span></span><span>);
</span></span>

이 접근법은 더 많은 작업이 필요하지만 완전히 제어 가능한 솔루션을 제공 할 수 있습니다.

요약

date_create_immutable 은 PHP 5.5 이상에 도입 된 매우 유용한 기능입니다. 불변의 dateTeimeMmutable 객체를 반환하여 날짜와 시간을 처리 할 때 원래 객체를 수정하여 발생하는 문제를 피할 수 있습니다. 그러나 낮은 버전의 PHP에서는이 기능을 사용할 수 없으므로 PHP를 업그레이드하거나 대안을 사용하거나 타사 라이브러리에 의존하여 호환성 문제를 해결해야합니다. 프로젝트의 특정 요구에 따라이 문제를 처리하기 위해 가장 적합한 솔루션을 선택할 수 있습니다.