WordPress의 고급 OOP : REST API 엔드 포인트 사용자 정의

(이 기사는 원래 Torque Magazine에 의해 출판되어 허가를 받아 재 인쇄되었습니다.) 최근 몇 년 동안 저자는 Torque Magazine의 객체 지향 PHP 및 WordPress REST API에 대한 많은 기사를 작성했으며, 여기에는 종속성 관리 및 자동 로딩 및 단위 테스트에 작곡가를 사용하는 것도 포함됩니다. 모든 기사의 핵심 요점은 다음과 같습니다. 기존 소프트웨어 개발 모범 사례를 WordPress 개발에 적용함으로써 더 나은 플러그인을 만들 수 있습니다.

이것은 이러한 개념을 실용적이고 기능적인 예에 ​​통합 할 일련의 기사 중 첫 번째입니다. WordPress REST API 엔드 포인트의 기능을 수정하여 검색을 더 잘 최적화하는 WordPress 플러그인을 만드는 방법을 살펴 보겠습니다. 플러그인은 Github에서 사용할 수 있습니다. 내 빌드 프로세스를 이해하려면 커밋 로그를 찾아야 할 수도 있습니다. 이 시리즈에서는 최신 객체 지향 PHP를 사용하여 플러그인 및 클래스를 작성하는 방법과 테스트 가능하게 만드는 방법 및 자동 테스트를 작성하는 방법을 다룹니다. 단위 테스트, 통합 테스트 및 수락 테스트의 차이점을 다루고 각 유형의 테스트를 작성하고 자동화하는 방법을 보여줍니다. 이 기사는 먼저 객체 지향 메소드를 사용하여 필터를 사용하여 WordPress REST API를 수정하는 방법을 소개합니다. 키 포인트

더 나은 검색 기능을 위해 객체 지향 PHP를 사용하여 WordPress REST API 엔드 포인트를 향상시키고 ElasticSearch와 같은 고급 검색 도구와 통합하십시오. <p> <rest> 기본 WordPress 검색의 한계를 우회하고 복잡한 쿼리의 응답 품질을 향상시키기 위해 나머지 API 엔드 포트 매개 변수 및 WP_Query 상호 작용을 수정하십시오. </rest></p> <ing> 단위 테스트, 통합 테스트 및 수락 테스트를 사용하여 강력하고 관리하기 쉬운 코드를 사용하여 각 구성 요소가 WordPress 생태계에서 올바르게 실행되도록합니다. <p> <inj> 의존성 주입 및 PHP 특성을 사용하여 클래스 종속성을 깨끗하게 관리하여 유지 보수 및 테스트 코드를 쉽게 할 수 있습니다. </inj></p> <ap> REST API 엔드 포인트 모드를 사용자 정의하여 와 같은 추가 매개 변수를 포함하여보다 유연하고 강력한 검색 기능을 허용합니다. <p> <adjust> 특정 REST API 요청을 통해 WP_Query 매개 변수를 동적으로 조정하고 필터를 사용하여 검색 결과 및 엔드 포인트 동작을 효과적으로 개선합니다. <strong> </strong> </adjust></p> REST API를 사용한 WordPress 검색 향상 <ul> <ins>는 일반적으로 searchWP 또는 attransi와 같은 플러그인을 사용하거나 WordPress 검색을 개선하기 위해 ElasticSearch (WordPress와 완전히 다른 스택을 사용하는 기술)와의 통합을 사용합니다. 이러한 유형의 플러그인은 더 나은 검색 결과를 제공하며 종종 다방면 검색 인터페이스와 함께 사용되며 전자 상거래 응용 프로그램에 매우 유용합니다. <li> WordPress REST를 통한 검색 API는 동일한 모든 문제와 동일한 솔루션을 상속합니다. 이 게시물에서는 먼저 검색의 작동 방식과 그 제한 사항을 소개합니다. 그런 다음 두 가지 다른 방법을 사용하여 검색을 수정하고 SearchWP와 통합하는 방법을 살펴 봅니다. </li> <search> WordPress의 내장 검색 기능은 일반적으로 외부 서비스를 사용하여 개선해야합니다. 이 기사는 WordPress Rest API Post 라우팅의 작동 방식을 수정하는 객체 지향적 접근 방식에 관한 것이지만 실제 예는 검색을 개선하는 것입니다. <p> <is> WordPress는 프론트 엔드 (기본 모바일 응용 프로그램 또는 VUE, React 또는 Angular를 사용하여 구축 될 수있는 원시 모바일 응용 프로그램 또는 웹 애플리케이션)를 분리하기위한 백엔드로 사용되면 나머지를 통해 고품질 검색을 수행하는 것이 중요합니다. API. 이 기사에 제시된 코드는 응용 프로그램 사용자가 여러 분류법을 기반으로 한 복잡한 알고리즘을 기반으로 올바른 제품 변형을 찾거나 콘텐츠를 검색 해야하는 경우 플러그인을 설치하는 대신 사용자 정의 코드를 작성하는 경우 도움이됩니다. </is></p> WordPress REST API <p> 를 사용한 게시물을 검색합니다 <to> 한 사이트의 게시물 유형의 "제품"으로 모든 게시물을 검색하려면 검색어 "Taco 셔츠"를 사용하면 </to></p> 엔드 포인트에 요청할 것입니다. 결과의 품질을 향상 시키려면 위에 나열된 솔루션이 도움이됩니다. <p> 위에서 언급 한 바와 같이, WP_Query (WordPress REST API의 후 끝점에 사용)는 좋은 검색 도구가 아닙니다. 보다 구체적으로, WP_Query는 MySQL에 대한 의존성으로 인해 NOSQL 데이터베이스를 사용하여 구축되는 전용 검색 도구보다 적을 수 있습니다. <strong> 먼저, REST API 요청을 할 때 WP_Query의 WordPress 데이터베이스 상호 작용을 우회하는 방법을 살펴 보겠습니다. </strong> <strategy> 이것은 많은 검색 플러그인이 자체 검색 시스템 결과 (WP_Query에 대해 기본적으로 생성)를 대체하기 위해 사용하는 전략입니다. 검색 시스템은 동일한 데이터베이스를 사용할 수 있습니다. 또한 Elasticsearch 또는 Apache Solr 서버와 같은 API 요청을 통해 다른 데이터베이스에 연결할 수도 있습니다. </strategy></p> <at> WordPress Core 코드를 보면 필터 "Posts_pre_Query"가 WP_Query 쿼리 데이터베이스 전에 실행되지만 SQL 쿼리가 준비된 후에는 실행됩니다. 이 필터는 기본적으로 NULL을 반환합니다. 값이 NULL 인 경우 WordPress는 기본 동작을 계속합니다. WordPress 데이터베이스를 쿼리하고 결과를 간단한 WP_POST 객체로 반환하십시오. <p> 반면에,이 필터의 반환 값이 배열 (WP_Post 개체를 포함하려는) 인 경우 WordPress의 기본 동작이 사용되지 않습니다. <code>/wp/v2/product?s=Taco Shirt</code> <how> Posts_pre_Query를 사용하여 시뮬레이션 된 WP_POST를 반환하는 방법을 살펴 보겠습니다. 이 전략은 테스트에 매우 유용하지만 동일한 스키마의 더 복잡한 버전을 사용하여 별도의 데이터베이스를 WordPress 사이트와 통합 할 수 있습니다. </how></p> 이 예에서는 모의 데이터를 사용하고 있지만 SearchWP의 쿼리 클래스 또는 다른 것을 사용할 수 있습니다. 이 코드에 대해 주목해야 할 또 다른 사항은 WordPress REST API가 만든 WP_Query 객체뿐만 아니라 WP_Query에서 실행된다는 것입니다. WordPress REST API 요청이 아닌 한 필터를 사용하지 않도록 수정합시다. <p> WordPress REST API 엔드 포인트 매개 변수 수정 </p> <p> <at> 우리는 단지 WordPress REST API 요청에 대해 생성 된 검색 결과를 변경하는 방법을 살펴 보았습니다. 이를 통해 더 나은 검색 결과를 위해 쿼리를 최적화 할 수 있지만 엔드 포인트의 다양한 패턴에 대한 필요성을 드러 낼 수 있습니다. </at></p>예를 들어, <if> 예를 들어, 제품 엔드 포인트를 검색하여 선택적으로 다른 게시물 유형을 검색에 포함시킬 수있게하려면 작년에 동일한 문제에 대한 다른 솔루션을 도입했습니다. <p> 수평 초점 </p> <to> 우리는 허용 된 엔드 포트 매개 변수를 수정하는 방법과 WP_Query 매개 변수를 만드는 방법을 살펴 보려고합니다. 이것들은 두 가지 별도의 관심사이며, 단일 책임 원칙에 따라 각 문제에 대한 클래스를 만들어야한다고 명시합니다. 그러나이 두 클래스는 우려를 공유 할 것입니다. <p> 예를 들어, <if> 다른 게시물 유형별로 쿼리를 허용하려면 공개 게시물 유형이 어떤 것이 어떤지, 슬러그 및 REST_BASE 매개 변수를 알아야합니다. 이 모든 정보는 get_post_types 함수에서 사용할 수 있습니다. <strong> <of>이 함수의 출력은 우리가 필요로하는 것이 아닙니다. 방금 나열된 요구 사항에 따라 데이터를 포맷하기 위해 클래스를 설계하고이를 액세스 할 수있는 도우미 방법을 제공하겠습니다. </of></strong> <as> 사용 가능한 컨테이너에서 사용해야하는 모든 포스트 유형 데이터에 대한 일반적인 모양으로 생각하십시오. </as></if></p> <of>는 클래스에서 get_post_types ()를 호출하는 대신 생성자를 통해 주입 된 종속성으로 사용합니다. 따라서이 클래스는 WordPress를로드하지 않고 테스트 할 수 있습니다. <p> <i> 이것이 내가 이런 종류를 "단위 테스트 가능"이라고 묘사하는 이유입니다. 다른 API에 의존하지 않으며 부작용에 대해 걱정하지 않습니다. 별도의 분리 된 장치로 테스트 할 수 있습니다. 초점을 분리하고 기능을 작은 부품으로 분리하고 일단 단위 테스트 범위가 있으면 코드를 쉽게 유지 관리 할 수 ​​있습니다. 다음 게시물 에서이 유형의 클래스를 테스트하는 방법을 다룰 것입니다. </i></p> <class>이 클래스는 wp_post_type에 의존한다는 것을 기억하십시오. 통합 테스트 만 WordPress 또는 기타 외부 종속성을 사용할 수 있으므로 내 단위 테스트는 클래스를 정의하지 않습니다. 이 클래스는 작업을 수행하지 않고 데이터를 나타내는 데만 사용됩니다. 따라서 우리는 그 사용에 부작용이 없다고 말할 수 있습니다. 그래서 나는 실제 wp_post_type 대신 단위 테스트에서 모의를 사용하고 싶습니다. <p> <ency> 의존성 주입에 대해 말하면,이 새로운 클래스의 객체가 필요한 클래스는 동일한 패턴을 따르고 싶습니다. 클래스에서 준비된 포스트 타입을 인스턴스화하는 대신, 우리는 인스턴스를 전달합니다. 이는 ProadePostTypes 및 ProadePostType를 사용하는 클래스가 분리되어 유지되며 별도로 테스트 될 수 있음을 의미합니다. </ency></p> <cause> 또한 종속성 주입을 가능하게 하고이 개체에 대한 속성을 설정해야하기 때문에 코드 재사용을 유발할 수 있습니다. Cut and Paste를 사용할 수 있거나 클래스 간의 방법과 속성을 복사하기위한보다 진보적이고 확장 가능한 방법 인 PHP 특성을 사용할 수 있습니다. <p> </p> <tr> 이것은 ProadePostTypes 객체를 다른 클래스에 주입하기위한 패턴을 설정하는 특성입니다.<div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><pre class='brush:php;toolbar:false;'>// ... (代码示例与原文相同) ...

로그인 후 복사

로그인 후 복사

로그인 후 복사