Upgrading from 4.1.4 to 4.1.5
설치 방법에 해당하는 업그레이드 지침을 참조하십시오.
Breaking Changes
BaseBuilder 및 Model 클래스의 set() 메소드 변경
매개 변수 $value
에 대한 캐스팅은 set()
메소드에 배열과 문자열 전달 방식이 다르게 처리되는 버그를 수정하기 위해 제거되었습니다.
BaseBuilder
클래스나 Model
클래스를 직접 확장하고 set()
메소드를 수정했다면, public function set($key, ?string $ value = '', ?bool $escape = null)
을 public function set($key, $value = '', ?bool $escape = null)
로 변경합니다.
세션 DatabaseHandler의 데이터베이스 테이블 변경
최적화를 위해 세션 테이블의 다음 열(column) 유형이 변경되었습니다.
- MySQL
timestamp
- PostgreSQL
ip_address
timestamp
data
세션 테이블의 정의를 업데이트합니다. 세션 라이브러리을 참조하십시오.
이 변경사항은 v4.1.2에서 소개되었습니다. 그러나 버그로 인해 데이터베이스 핸들러 드라이버가 제대로 작동하지 않았습니다.
CSRF 보호
CSRF 필터를 적용하면 버그 수정으로 인해 CSRF 보호는 POST뿐만 아니라 PUT/PATCH/DELETE 요청에도 작동합니다.
PUT/PATCH/DELETE 요청을 사용하는 경우 CSRF 토큰을 전송해야 합니다. 요청에 대해 CSRF 보호가 필요하지 않은 경우 해당 요청에 대한 CSRF 필터를 제거하십시오.
이전 버전과 동일한 동작을 원한다면 app/Config/Filters.php에서 CSRF 필터를 다음과 같이 설정합니다.
<?php
namespace Config;
use CodeIgniter\Config\BaseConfig;
class Filters extends BaseConfig
{
// ...
public $methods = [
'get' => ['csrf'],
'post' => ['csrf'],
];
// ...
}
GET 메소드 보호는 form_open()
에 의한 CSRF 필드 자동 생성을 사용하는 경우에만 필요합니다.
Warning
일반적으로 $methods
필터를 사용하는 경우 disable Auto Routing (Legacy)을 수행해야 합니다.
자동 라우팅(레거시)은 모든 HTTP 메서드가 컨트롤러에 액세스할 수 있도록 허용하기 때문입니다.
예상하지 못한 방법으로 컨트롤러에 액세스하면 필터를 우회할 수 있습니다.
CURLRequest 헤더 변경
이전 버전에서는 헤더를 제공하지 않은 경우 CURLRquest
가 브라우저의 요청 헤더를 보냅니다.
그 버그는 수정되었습니다. 요청이 헤더에 종속된 경우 업그레이드 후 요청이 실패할 수 있습니다.
이 경우 필요한 헤더를 수동으로 추가합니다.
추가하는 방법에 대해서는 CURLRequest Class를 참조하십시오.
쿼리 빌더 변경
최적화 및 버그 수정을 위해 테스트에 주로 사용되는 동작이 다음과 같이 변경되었습니다.
insertBatch()
와updateBatch()
를 사용할 때$query->getOriginalQuery()
의 반환 값이 변경되었습니다. 더 이상 바인딩된 매개 변수로 쿼리를 반환하지 않고 실행된 실제 쿼리를 반환합니다.testMode
가true
이면insertBatch()
는 영향을 받는 행 수 대신 SQL 문자열 배열을 반환합니다. 반환된 데이터 유형이updateBatch()
메소드와 동일하도록 변경되었습니다.
Breaking Enhancements
경로에 대한 다중 필터
경로에 대해 다중 필터를 설정하는 새로운 기능입니다.
Important
이 기능은 기본적으로 비활성화되어 있습니다. 역호환성을 깨기 때문입니다.
If you want to use this, you need to set the property $multipleFilters
true
in app/Config/Feature.php
.
If you enable it
이 기능을 사용하려면 app/Config/Feature.php
파일에서 $multipleFilters
속성을 true
로 설정해야 합니다.
활성화되면
CodeIgniter\CodeIgniter::handleRequest()
사용enableFilter()
대신CodeIgniter\Filters\Filters::enableFilters()
를 사용합니다.
CodeIgniter\CodeIgniter::tryToRouteIt()
사용getFilter()
대신CodeIgniter\Router\Router::getFilters()
를 사용합니다.
CodeIgniter\Router\Router::handle()
사용속성
$filterInfo
대신$filtersInfo
를 사용합니다.getFilterForRoute()
대신CodeIgniter\Router\RouteCollection::getFiltersForRoute()
를 사용합니다.
위의 클래스를 확장했다면 변경해야 합니다.
다음 메서드와 속성은 더 이상 사용되지 않습니다.
CodeIgniter\Filters\Filters::enableFilter()
CodeIgniter\Router\Router::getFilter()
CodeIgniter\Router\RouteCollection::getFilterForRoute()
CodeIgniter\Router\RouteCollection
’s property$filterInfo
각 기능에 대해서는 필터 적용를 참조하십시오.
Project Files
프로젝트 공간에 있는 수많은 파일(루트, 앱, 공용, 쓰기 가능)이 업데이트를 받았습니다. 이러한 파일은 시스템 범위를 벗어났기 때문에 사용자의 개입 없이는 변경되지 않습니다. 프로젝트 공간의 변경 사항을 병합하는 데 도움이 되는 타사 CodeIgniter 모듈은 Packagist에서 찾을 수 있습니다.
Note
버그 수정에 대한 매우 드문 경우를 제외하고 프로젝트 공간의 파일을 변경해도 응용 프로그램이 손상되지 않습니다. 여기에 명시된 모든 변경 사항은 다음 주요 버전까지 선택 사항이며, 필수 변경 사항은 위의 섹션에서 다룹니다.
Content Changes
다음 파일에는 중요한 변경 사항(더 이상 사용되지 않음 또는 시각적 조정 포함)이 있으므로 업데이트된 버전을 응용 프로그램과 병합하는 것이 좋습니다.
app/Config/CURLRequest.php
app/Config/Cache.php
app/Config/Feature.php
app/Config/Generators.php
app/Config/Publisher.php
app/Config/Security.php
app/Views/welcome_message.php
All Changes
다음은 프로젝트 공간에서 변경사항이 있는 모든 파일의 목록입니다. 대부분은 런타임에 영향을 미치지 않는 간단한 주석 또는 형식입니다.
app/Config/CURLRequest.php
app/Config/Cache.php
app/Config/Feature.php
app/Config/Generators.php
app/Config/Kint.php
app/Config/Publisher.php
app/Config/Security.php
app/Views/welcome_message.php