php-http 및 httplug로 Guzzle5에서 벗어나십시오

키 테이크 아웃

PHP-HTTP의 프로젝트 인 HTTPlug는 모든 HTTP 클라이언트를 SDK에 쉽게 주입 할 수 있으므로 이미 선호하는 HTTP 클라이언트가 사용 중이며 Guzzle 사용을 피하려는 응용 분야에 대한 솔루션을 제공합니다. httplug 인터페이스 패키지와 Guzzle 6을 Composer를 사용하여 함께 가져올 수 있습니다. 이를 통해 HTTPlug의 HTTPClient 인터페이스를 구현하는 Guzzle 6 또는 다른 어댑터를 사용할 수 있습니다. PHP-HTTP 프로젝트는 Guzzle 5 및 6 및 Zend1 및 2를 포함하여 PHP의 모든 HTTP 클라이언트를 최대한 지원하는 것을 목표로합니다. 이는 설치된 클라이언트 버전과 충돌 할 수 없으며 적절한 어댑터를 쉽게 연결할 수 없습니다. <.> DiffBot SDK는 PSR-7과 호환되고 HTTP 클라이언트의 다른 구현을 수용했습니다. 모든 것이 박스에서 작동하기 위해 HTTPlug 인터페이스를 존중하는 어댑터 만 있으면됩니다. httplug는 앱에서 HTTP 클라이언트 구현을 추상화하는 새로운 접근 방식을 제공하여 하나의 추가 추상화 계층의 비용에 대한 확장 성을 제공합니다.

이 기사는 Márk Sági-Kazár와 David Buchmann이 검토 한 동료입니다. Sitepoint 콘텐츠를 최선을 다해 Sitepoint의 동료 리뷰어 덕분에!

이전 시리즈에서는 DiffBot 용 PHP 클라이언트를 구축했습니다. 클라이언트는 잘 작동하고 상대적으로 널리 사용됩니다 - 우리는 심지어 라이브 앱에서 그것을 테스트하여 PAR에 달려 있는지 확인했지만 Guzzle 5에 크게 의존합니다.

. 이것에는 두 가지 문제가 있습니다 :
• Guzzle 6이 나오고 PSR 7을 지원합니다. Guzzle의 저자는 Guzzle 5가 가까운 미래를 위해 지원 될 것이지만, 수명에 회의적인 것이 더 안전합니다. 게다가, PSR 7은 기발한 것을 가질 수 있지만 다른 프로젝트와의 호환성에 대해서만 PSRS를 따르는 것이 좋습니다. 앱에서 클라이언트를 구현하는 사람은 이미 선호하는 HTTP 클라이언트가 사용 중이며 Guzzle 대신 사용을 원합니다. 우리는
http 클라이언트를 SDK에 쉽게 주입 할 수 있어야합니다.
우연히도, 우리가 그렇게 할 수있는 새로운 프로젝트가 있습니다.
• 참고 : DiffBot SDK의 내부 논리에 익숙하지 않아도됩니다. 이 기사의 프로세스는 콘크리트 HTTP 클라이언트 구현이있는 모든 패키지에 적용 할 수 있으며 따르기 쉽습니다. php-http 및 httplug PHP-HTTP는 PHP의 HTTP 관련 도구를위한 GitHub 조직입니다. PSR-7 요청 및 응답 위에 최소 HTTP 클라이언트 계약을 정의하기 위해 인터페이스 및 예외 모음 인 HTTPlug를 제공합니다. 이 계약의 구현 가상 패키지 php-http/client-implementation을 제공합니다 이것은 Guzzle 6을 사용하는 사람이 작곡가를 캔자에게 httplug 인터페이스 패키지를 가져 오려면 php-http/guzzle6-adapter가 필요하다는 것을 의미합니다. httplug는 재사용 가능한 패키지의 진입 점입니다. 클라이언트 추상화는 모든 클라이언트 (Guzzle6 어댑터와 같은)가 기반으로합니다. 그런 다음이 클라이언트는 기본 패키지 / 의존성을 사용합니다 -이 경우 Guzzle 6. 그래서 하단에서 상단 :

  http 클라이언트가 존재합니다 (Guzzle 6) guzzle 6 어댑터는 httplug로 인터페이스로 구축되며, guzzle 6

  . http 호출을 만들 수 있어야하는 앱은 클라이언트가 필요합니다. httplug의 httpclient 인터페이스가 필요합니다. 그런 다음 앱은 Guzzle 6 또는 Httplug의 httpclient 인터페이스를 구현하고 다른 제 3 자 http 클라이언트를 포장하는 다른 어댑터를 사용할 수 있습니다.

  팀의 계획은 PHP 토지의 모든 다양한 HTTP 클라이언트 (Guzzle 6, Guzzle 5, Zend2, Zend1 등)를 최대한 지원하는 것입니다. 그렇듯이 프레임 워크 또는 앱의 사용자는 설치와 충돌하지 않습니다. 클라이언트 버전은 단순히 적절한 어댑터를 믹스에 연결합니다.

  우리는 어댑터 및 클라이언트

  용어를 거의 상호 교환 적으로 사용합니다. httplug를 기반으로 한 어댑터는 둘 다입니다. 그들은 기존 클라이언트 주변의 포장지이지만 고객 자체로 직접 사용됩니다.

  이 게시물의 계획은 Diffbot의 PHP 클라이언트의 콘크리트 Guzzle 5 의존성을 HTTPlug 버전으로 대체하는 것입니다. 참고 : httplug 및 관련 패키지는 알파 소프트웨어이므로 변경 될 수 있습니다. 그것들을 사용하도록 모든 것을 변환하는 것은 위험한 노력입니다.
  • 부트 스트랩 평소와 같이, 우리는 홈스테드를 사용하여 환경을 부트 스트랩하는 것이 좋습니다. 준비가되면 SDK의 현재 안정적인 버전을 복제하고 테스트 할 수 있습니다.
  마지막 명령은 PHPUnit이 개발 환경에 전 세계적으로 설치된다고 가정합니다. 모든 테스트는 통과해야합니다 (말도 안되는 소리로 인해 버그가 늘어나고 픽스 할 수없는 건축 된 테스트 제외).
  • 시작하기
  먼저, 우리는이 업그레이드를 개발할 새 지점을 만들어야합니다.
  • 그런 다음 Composer.json 파일에 두 가지 종속성을 추가합니다

    git clone https://github.com/swader/diffbot-php-client
    cd diffbot-php-client 
    git checkout tags/0.4.5 
    composer install
    phpunit
    

    이것이하는 일은 이제 클라이언트에게 지금부터

    가상 패키지 에 달려 있다고 말하는 것입니다. 이는 사용하려면 DiffBot 클라이언트를 사용하는 응용 프로그램 (이와 같은) 은이 패키지의 구현 (Packagist 링크에 나열된 패키지 중 하나)을 선택해야 함을 의미합니다. 물론 패키지를 개발하는 동안 실제 구현없이 모든 것이 작동하는지 테스트하고 확인하는 것은 불가능하므로 추가 요구 사항 종속성을 지정합니다. 위의 특정 사례에서는 "php-http/guzzle6-adapter": "~ 0.2@dev"를 사용합니다. 우리는 그것이 최신 버전이고 안정적인 릴리스가 없기 때문에 특정 버전을 선택했습니다. 참고 : 우리가 일반적으로 우리가 평소처럼 터미널에서 상호 작용하여 종속성을 상호 작용하는 대신 composer.json에 값을 추가하는 방법을 사용했는지 궁금 할 것입니다. 가상 패키지에서 작곡가를 요구하면 오류가 발생하지 않기 때문에 패키지는 실제로 존재하지 않으며 가상 이름, 자리 표시 자일 뿐이므로 작곡가는 설치해야 할 사항을 모르고 혼란스러워집니다. 이것에 대한 변화를 암시하는 문제가 있지만 곧 일어나지 않을 것입니다. .

    PHP-HTTP 패키지는 여전히 큰 개발 중이므로 Composer.json 파일에 다음 두 값을 추가해야합니다.

    이것은 Dev 패키지를 설치할 수 있지만 (Non-Stable), 존재하는 경우 안정적인 버전을 선호합니다. 따라서 매우 불안정한 PhPunit 5.2.x를 가져 오기보다는 5.0.8 (가장 중요한 글쓰기시 최신)을 가져 오지만, 가지고 있지 않은 패키지를 요청하면 성공할 것입니다. 안정적인 릴리스 (Guzzle6-Adapter와 같은) Guzzle6을 설치하려면 Guzzle5에 대한 종속성을 제거해야합니다. 최종은 블록이 다음과 같이 보입니다.

    계획 SDK가 현재 작동하는 방식은 다음과 같습니다. 기본 Diffbot 클래스에서는 선택적으로 httpclient를 설정합니다. 이것은 현재 버전 5에서 Guzzle의 구현에 바인딩됩니다. 사용자 정의 클라이언트 인스턴스가 설정되지 않으면 DiffBot 클래스는 기본 클라이언트를 자동으로 사용합니다. 그런 다음이 클라이언트는 API Abstract의 호출 방법에 의해 주어진 URL에 GET 요청을 발행하기 위해 사용됩니다. 또한 크롤링 API 클래스 및 검색 API 클래스에는 사용자 정의 통화 메소드가 있습니다. 통화 결과는 $ 응답으로 저장되며 이는 GUZZE5 응답입니다. 그런 다음 해당 응답은 유효성을 확인하고 엔티티를 구축하여 엔티티 반복자로 밀어 넣는 Entity Factory에서 추가로 처리됩니다. 계획은 다음과 같습니다

    diffbot :: sethttpclient를 httplug 구현을 수락하는 방법으로 대체하십시오 API 초록, 크롤링 및 검색 클래스의 통화 메소드를 수정하여 제공된 HTTP 클라이언트 구현으로 GET 요청을 발행 할 수 있습니다. 엔티티 팩토리 및 엔티티 반복자가 더 이상 Guzzle5 버전의 응답에 의존하지 않고 PSR-7 대응 물에 의존하지 않도록 수정하십시오.
    1. PHP-HTTP 프로젝트에는 추가 패키지 인 Utils가 있으며 여기에는 httpmethodsclient가 포함되어 있습니다. 이 클래스는 메시지 공장과 HTTP 클라이언트를 전체적으로 랩핑하여 Get, Post 등과 같은 일반적으로 사용되는 동사로 요청을 더 쉽게 보낼 수 있도록합니다. 따라서 지금까지 가지고있는 것과 비슷한 것 : $ client-> get (. ..). 또한 PSR-7 ResponseInterface도 반환합니다. 즉, GetBody 메소드가 우리에게 사용할 수 있음을 의미합니다. 즉, Tojson 메소드 만 구현되지 않은 상태로 유지됩니다. 또한 프로젝트에는 설치 공장 및 클라이언트를 발견하기위한 정적 클래스가 특징 인 발견 구성 요소가 있습니다.이를 통해 최종 사용자는 일부 경우에 제로 구성 경험을 제공 할 수 있습니다 (문서 참조). 전투 계획을 세우면 리팩토링을 시작할 수 있습니다. 전제 조건 추가 패키지가 필요합니다
    diffbot 클래스 diffbot 클래스는이 줄이 맨 위에 있습니다 :
    2. 우리는 그것을 바꿀 수 있습니다 :
    sethttpclient 메소드는 이제 IDE에서 플레어를 타야하며, 필요한 매개 변수, 즉 사용할 클라이언트, 요청 인스턴스를 구축 할 메시지 공장이 누락되었다고 말해야합니다. 메소드는 다음과 같이 리팩토링되어야합니다
    3. 또는 디스커버리 클래스는 클래스 상단의 사용 명령문으로 수입 할 수 있습니다.
    이 변경 사항은 이제 DiffBot SDK의 최종 사용자가 다음 중 하나를 허용했습니다.
    자체 클라이언트를 설치하고 HTTPMethodSclient와 함께 발견 된 검색 구성 요소를 자동으로 처리하거나 PSR 7 클라이언트의 사용자 정의 인스턴스와 메시지 공장을 새로운 인스턴스에 주입하여 자체 httpmethodsclient 인스턴스를 구성하고 를 SethttPclient 메소드에 전환하여 완전한 유연성
    대부분의 사용자는 이것을 자동 조종 장치에서 사용합니다 API Abstract, Crawl 및 Search 다음으로, 호출 방법.

    이전에 구현 한 httpmethodsclient 인스턴스에는 get 메소드가 있기 때문에 그와 관련하여 변경 사항이 필요하지 않습니다. 그러나 $ 응답 인스턴스는 미스트 매치를 보여주고 그럴만 한 이유가 있습니다. EntityFactory가 기대하는 원래 $ 응답은 Guzzle5 응답입니다.

    EntityFactory가 발행 한 불만으로 인해 API 초록을 편집 할 필요는 없습니다. 자체적으로 사물을 처리 할 것입니다. 크롤링 클래스의 통화 대응 물은 약간 다릅니다

    여기서 두 가지 경고 - JSON $ 응답 메소드를 사용하는 메소드의 두 번째 줄과 Guzzle5 응답을 기대하는 EntityIterator Instantiation. 여기에서 우리가 영향을 줄 수있는 유일한 줄은 전자이므로 다음과 같이 변경합시다.

    검색 클래스의 호출 메소드에서 유사한 변경이 수행되어야합니다.

    git clone https://github.com/swader/diffbot-php-client
    cd diffbot-php-client 
    git checkout tags/0.4.5 
    composer install
    phpunit
    

    로 변경 :

    엔티티 팩토리

    EntityFactory 클래스는 상단에 다음과 같은 가져 오기를 가지고 있습니다.

    git checkout -b feature-httplug
    

    우리는 이것을 다음과 같이 바꿀 수 있습니다 :

    EntityFactory 클래스가 구현하는 EntityFactory 인터페이스에서 동일해야합니다. 다른 변화는 크롤링 클래스에서 위에서 한 것과 비슷합니다. 우리는 변화 :

    	"require": {
            ...
            "php-http/client-implementation": "^1.0"
        },
        "require-dev": {
            ...
            "php-http/guzzle6-adapter": "~0.2@dev"
        },
    

    ~

    CheckResponseFormat 및 CreateApprepteriTerator 메소드에서 엔티티 반복자 우리는 변화 :

    "prefer-stable": true,
    "minimum-stability": "dev"
    

    ~

    테스트 HTTP 요청 및 API 호출을 테스트하는 주요 방법 인 조롱은 Guzzle 6에서 다르므로 테스트에는 약간 더 큰 점검이 필요합니다. 이 튜토리얼은 이미 긴 측면에 있으므로 Guzzle 5와 Guzzle 6 사이의 조롱 차이점, 특히 Diffbot SDK의 두 버전 간의 조롱 차이에 관심이 있으시면 관련 기능 지점을 참조하십시오. . 마지막으로, 테스트를 실행합시다 :

        "require": {
            "php" : ">=5.4.0",
            "php-http/client-implementation": "^1.0"
        },
        "require-dev": {
            "symfony/var-dumper": "~2",
            "phpunit/phpunit": "^5.0",
            "php-http/guzzle6-adapter": "~0.2@dev"
        },
    

    성공! 모든 통과 (예상 건너 뛰기 테스트 제외). DiffBot SDK는 이제 PSR-7과 호환 될뿐만 아니라 다른 HTTP 클라이언트의 구현을 수용 할 수 있습니다. 필요한 것은 httplug 인터페이스를 존중하는 어댑터이며 모든 것이 상자에서 작동해야합니다.
    결론 httplug는 우리가 구축하는 앱에서 HTTP 클라이언트 구현을 추상화하는 유용한 새로운 접근법입니다. PHP-HTTP는 HTTP 클라이언트를 직접 구축하든 다른 앱에서 사용하든, 추가 추상화 계층의 합리적인 가격에 대한 완전히 새로운 확장 성 세계를 제공합니다. 더 많은 어댑터 구현을 추가하거나 패키지를 사용하여 피드백을 제공하여 도움을주고 싶다면 팀은 모든 기여를 환영합니다. 아래의 의견 섹션에서 연락을 취하거나 피드백을 남겨 두고이 튜토리얼이 흥미로워지면 버튼을 누르는 것을 잊지 마십시오! . PHP http 및 httplug 에 대한 자주 묻는 질문 (FAQ) Guzzle5와 PHP HTTP/HTTPLUG의 차이점은 무엇입니까?

    Guzzle5와 PHP HTTP/HTTPLUG는 모두 PHP에 사용되는 HTTP 클라이언트입니다. Guzzle5는 특정 HTTP 클라이언트이며 PHP HTTP는 HTTP 클라이언트를 사용할 수있는 추상화 계층입니다. Httplug는 추가 기능을 제공하는 PHP HTTP의 확장입니다. 주요 차이점은 PHP HTTP 및 HTTPlug가 특정 HTTP 클라이언트와 연결되지 않기 때문에 유연성과 상호 운용성을 더 많이 허용한다는 것입니다.

    Guzzle5에서 PHP http/httplug로 어떻게 마이그레이션합니까? > Guzzle5에서 PHP HTTP/HTTPLUG로 마이그레이션하려면 GUZZE5 클라이언트를 PHP HTTP 인터페이스를 구현하는 어댑터로 교체하는 것이 포함됩니다. 이것은 Guzzle5를 포함한 다양한 HTTP 클라이언트를위한 어댑터를 제공하는 HTTPlug 라이브러리를 사용하여 수행 할 수 있습니다. 어댑터가 설정되면 PHP HTTP 메소드를 사용하여 요청을 보내고 응답을 처리 할 수 ​​있습니다.

    Guzzle5를 통해 PHP HTTP/HTTPLUG를 사용하면 어떤 이점이 있습니까? Guzzle5를 통해 php http/httplug를 사용하는 것은 유연성과 상호 운용성이 증가합니다. PHP HTTP/HTTPLUG를 사용하면 코드를 변경하지 않고 다른 HTTP 클라이언트간에 전환 할 수 있습니다. 이를 통해 다른 클라이언트로 응용 프로그램을보다 쉽게 ​​테스트하고 필요한 경우 고객을 전환 할 수 있습니다. 또한 HTTPlug는 HTTP 클라이언트에 기능을 추가 할 수있는 플러그인 시스템을 제공합니다.

    PHP HTTP/HTTPLUG? PHP http/httplug를 Composer를 사용하여 설치할 수 있습니다. PHP 용 종속성 관리 도구. Comment Composer가 PHP-HTTP/httplug가 필요한 명령을 실행하여 설치할 수 있습니다. 이것은 httplug 라이브러리와 그 종속성을 다운로드합니다.
    php http/httplug를 사용하여 요청을 보내는 방법은 무엇입니까?

    php http/httplug로 요청을 보내려면 먼저 생성해야합니다. 요청 객체. 이것은 MessageFactory 인터페이스의 Createrequest 메소드를 사용하여 수행 할 수 있습니다. 요청 오브젝트가 있으면 HTTPClient 인터페이스의 SendRequest 메소드를 사용하여 보낼 수 있습니다.

    PHP HTTP/HTTPLUG?
    의 응답을 어떻게 처리합니까? ResponseInterface 인터페이스로 표시됩니다. GetStatuscode, getheaders 및 getbody 메소드를 사용하여 상태 코드, 헤더 및 응답 본문에 각각 액세스 할 수 있습니다.

    PHP HTTP/HTTPLUG에서 발견 구성 요소의 목적은 무엇입니까? 🎜> PHP HTTP/HTTPLUG의 검색 구성 요소는 사용 가능한 HTTP 어댑터 및 메시지 공장을 자동으로 찾아 사용하는 데 사용됩니다. 이를 통해 다른 HTTP 클라이언트간에 전환하고 사용 가능한 최상의 구현을보다 쉽게 ​​전환 할 수 있습니다.

    PHP http/httplug에서 검색 구성 요소를 어떻게 사용합니까?
    발견 구성 요소는 사용할 수 있습니다. httpclientDiscovery 또는 MessageFactoryDiscovery 클래스에서 정적 찾기 메소드를 호출합니다. 이것은 사용 가능한 첫 번째 HTTP 클라이언트 또는 메시지 공장의 인스턴스를 반환합니다.

    . httplug의 플러그인은 무엇이며 어떻게 사용합니까?

    httplug의 플러그인은 HTTP 클라이언트에 기능을 추가하는 데 사용됩니다. 인증, 캐싱 및 오류 처리와 같은 기능을 추가하는 데 사용할 수 있습니다. 플러그인 클래스 클래스의 AddPlugin 방법을 사용하여 플러그인을 클라이언트에 추가 할 수 있습니다.

    PHP HTTP/HTTPLUG의 오류를 어떻게 처리합니까?

    PHP http/httplug의 오류는 예외로 표시됩니다. httpclientException 인터페이스를 구현하십시오. 이러한 예외를 포착하여 필요에 따라 처리 할 수 ​​있습니다. 또한 ErrorPlugin을 사용하여 비 2000 응답을 자동으로 예외로 변환 할 수 있습니다.

위 내용은 php-http 및 httplug로 Guzzle5에서 벗어나십시오의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!