Pārskats¶

Prasības¶

PHP 7.2.5
Lai izmantotu PHP plūsmas apstrādātāju, allow_url_fopen ir jābūt iespējotai jūsu php.ini.
Lai izmantotu cURL apstrādātāju, ir jābūt jaunākajai cURL versijai >= 7.19.4. kompilēta ar OpenSSL un zlib.

Piezīme

Guzzle vairs neprasa cURL, lai nosūtītu HTTP pieprasījumus. Guzzle HTTP pieprasījumu nosūtīšanai izmantos PHP plūsmas apvalku, ja cURL nav instalēts. Varat arī nodrošināt savu HTTP apstrādātāju, ko izmanto pieprasījumu nosūtīšanai. Paturiet prātā, ka cURL joprojām ir nepieciešams vienlaicīgu pieprasījumu nosūtīšanai.

Uzstādīšana¶

Ieteicamais veids, kā instalēt Guzzle, ir, izmantojot Composer. Composer ir atkarību pārvaldības rīks PHP, kas ļauj deklarēt projektam nepieciešamās atkarības un instalē tās projektā.

# Install Composer
curl -sS https://getcomposer.org/installer | php

Izmantojot Composer, varat pievienot Guzzle kā atkarību:

composer require guzzlehttp/guzzle:^7.0

Varat arī norādīt Guzzle kā atkarību esošajā projekta composer.json failā:

 {
   "require": {
      "guzzlehttp/guzzle": "^7.0"
   }
}

Pēc instalēšanas ir nepieciešams pieprasīt Composer autoloader:

require 'vendor/autoload.php';

Vairāk par to, kā instalēt Composer, konfigurēt automātisko ielādēšanu un citu labāko atkarību definēšanas praksi, varat uzzināt vietnē getcomposer.org.

Asiņošana¶

Izstrādes laikā varat sekot līdzi jaunākajām izmaiņām galvenajā atzarā, iestatot Guzzle versijas prasību uz ^7.0@dev.

{
   "require": {
      "guzzlehttp/guzzle": "^7.0@dev"
   }
}

Licence¶

Licencēts, izmantojot MIT licenci.

Copyright (c) 2015 Michael Dowling <https://github.com/mtdowling>

Ar šo tiek piešķirta atļauja bez maksas jebkurai personai, kas iegūst kopiju. šīs programmatūras un saistīto dokumentācijas failu ("Programmatūra"), lai veiktu darījumus ar šo programmatūru un ar to saistītajiem dokumentācijas failiem ("Programmatūra"). ar programmatūru bez ierobežojumiem, tostarp, bet ne tikai, ar tiesībām izmantot, kopēt, modificēt, apvienot, publicēt, izplatīt, licencēt un/vai pārdot. Programmatūras kopijas, un atļaut personām, kurām Programmatūra tiek programmatūra ir piegādāta, ievērojot šādus nosacījumus:

Iepriekš minētais paziņojums par autortiesībām un šis paziņojums par atļauju jāiekļauj visās programmatūras kopijās vai būtiskās daļās.

PROGRAMMATŪRA TIEK NODROŠINĀTA "TĀDA, KĀDA TĀ IR", BEZ JEBKĀDAS GARANTIJAS, TIEŠAS VAI TIEŠAS. GARANTIJAS, TOSTARP, BET NE TIKAI, GARANTIJAS PAR DERĪGUMU, PIEMĒROTĪBU KONKRĒTAM MĒRĶIM UN TO, KA NETIEK PĀRKĀPTI NOTEIKUMI. NEKĀDĀ GADĪJUMĀ AUTORI VAI AUTORTIESĪBU TURĒTĀJI NAV ATBILDĪGI PAR JEBKĀDĀM PRASĪBĀM, ZAUDĒJUMIEM VAI CITIEM ATBILDĪBU, KAS IZRIET NO LĪGUMA, CIVILTIESĪBU PĀRKĀPUMA VAI KĀ CITĀDI, KAS IZRIET NO, NO VAI SAISTĪBĀ AR PROGRAMMATŪRU VAI TĀS LIETOŠANU VAI CITIEM DARĪJUMIEM, KAS SAISTĪTI AR PROGRAMMATŪRU VAI TĀS LIETOŠANU VAI CITIEM DARĪJUMIEM, KAS SAISTĪTI AR PROGRAMMATŪRU VAI TĀS LIETOŠANU VAI CITIEM DARĪJUMIEM. PROGRAMMATŪRU.

Veicināt¶

Vadlīnijas¶

Guzzle izmanto PSR-1, PSR-2, PSR-4 un PSR-7.
Guzzle ir paredzēts kā vienkāršs un ātrs rīks ar ļoti maz atkarībām. Tas nozīmē, ka ka ne katrs funkciju pieprasījums tiks pieņemts.
Guzzle minimālā PHP versijas prasība ir PHP 7.2. Pull pieprasījumiem jābūt nedrīkst prasīt PHP versiju, kas ir augstāka par PHP 7.2, ja vien funkcija nav tikai PHP 7.2. tiek izmantota tikai nosacīti un failu var analizēt ar PHP 7.2.
Visos vilkšanas pieprasījumos jāiekļauj vienības testi, lai nodrošinātu, ka izmaiņas darbojas kā un lai novērstu regresijas.

Testu veikšana¶

Lai sniegtu savu ieguldījumu, jums būs jāizņem avots no GitHub un jāinstalē Guzzle atkarības, izmantojot Composer:

git clone https://github.com/guzzle/guzzle.git
cd guzzle && composer install

Guzzle tiek testēts, izmantojot PHPUnit. Palaidiet testus, izmantojot Makefile:

make test

Piezīme

Lai veiktu integrāciju, ir nepieciešams instalēt mezglu.js v8 vai jaunāku versiju. testus ar Guzzle HTTP apstrādātājiem.

Ziņošana par drošības ievainojamību¶

Mēs vēlamies nodrošināt, lai Guzzle būtu droša HTTP klienta bibliotēka ikvienam. Ja esat atklājuši drošības nepilnības Guzzle, mēs būsim pateicīgi par jūsu palīdzību. atklājot to mums atbildīgā veidā.

Publiski atklājot kādu ievainojamību, var tikt apdraudēta visa kopiena. Ja esat atklājis drošības problēmu, lūdzu, rakstiet mums uz šādu adresi security@guzzlephp.org. Mēs strādāsim kopā ar jums, lai pārliecinātos, ka mēs saprotam. problēmas apjomu un pilnībā atrisināsim jūsu bažas. Mēs apsveram saraksti, kas nosūtīta uz security@guzzlephp.org mūsu augstāko prioritāti un strādājam, lai pēc iespējas ātrāk risināt visas radušās problēmas.

Pēc tam, kad drošības ievainojamība būs novērsta, pēc iespējas ātrāk tiks izlaists drošības labojums.

Saturs