WordPressi helilooja, 1. osa

Olgu, pärast kõigi erinevate teekide läbirääkimist, mis võivad aidata teie töö koodikvaliteeti parandada, tekitab see siiski küsimuse:

Kuidas panna need projektid meie koodibaasi vastu töötama?

Lühidalt, selleks on vaja heliloojat. Kui te pole seda kunagi kasutanud, olen sellest varem lühidalt kirjutanud, kuid kavatsen anda põhitõed selle kohta, mida vajate selle kasutamise alustamiseks ja ülalnimetatud teegid teie töös.

Nii selles kui ka järgmises postituses jagan, kuidas kõike kohapeal kõige elementaarsemal kujul seadistada ja kuidas see Gitiga integreerub, et saaksite seda oma igapäevaelus kasutama hakata.

Helilooja konfigureerimine WordPressi jaoks

Seal on palju teavet, mida saab (ja ma väidan, et see peaks minema Composeri faili). See hõlmab selliseid asju nagu teave autori kohta, PSR, teave jne. Kuid see ei kuulu selle postituse ulatusse. Selle asemel tahan jagada minimaalset teavet selle teabe seadistamiseks ja konfigureerimiseks.

Näidiskataloog

Oletame, et alustate hetkeks tööd WordPressiga seotud pistikprogrammi või millegi kallal, mis nõuab erinevaid eelmises seerias käsitletud teeke. Ja kui seadistate selle jaoks kataloogi, on teil väga vähe faile. Võib paar tühja PHP-faili, vara jne. Võib-olla näeb see välja selline:

Tõsi, ülaltoodud näide on juba veidi ees sellest, milline võib teie töö välja näha, kuna:

• Seal on composer.lock fail, mis näitab, et Composer on käivitatud,
• Sellel on vendor kataloog, mis näitab, et teegid on installitud Composeri kaudu,
• Seal on grumphp.yml fail, mis määrab, kuidas GrumPHP peaks koodi nuuskimisel töötama (ja ma käsitlen seda hiljem).

Kuid ülaltoodu olemus on sama: teil on composer.jsonja see määratleb ja sisaldab eelmise postituse põhjal kõike, mida me vajame. Kuidas me siis selle seadistame?

Helilooja seadistamine

Esiteks peab teil olema idee, kuidas kavatsete oma pistikprogrammi struktureerida. Näiteks on mul selline pistikprogrammi seadistus:

• Kõik PHP-failid asuvad src kataloogis,
• Kõik CSS, JavaScript, pildid jne failid on assets kataloogis,
• Kataloog vendor on mõeldud asjade jaoks, mis on installitud Composeri kaudu,
• views on see, mida kasutatakse projekti esiotsas.

Näiteks:

Teiseks soovite kõnealuses kataloogis luua faili nimega composer.json. Seda saab teha terminali kaudu, andes lihtsalt touch käsu, või saate selle luua oma IDE-s.

Oluline on see, et seal on src kataloog, sest see on kataloog, mis sisaldab meie PHP-faile ja see on kataloog, mida me tahame nuusutada.

Põhiline helilooja fail

Seda arvestades on siin composer.jsonpõhifail, mida saate oma projektides kasutada eelmiste seeriate ja allpool jagatu põhjal :

{
  "name": "pressware/demo-wordpress-plugin",
  "description": "This file is used to show how to configure a WordPress plugin using Composer.",
  "autoload": {
    "psr-4": {
      "Pressware": "src/"
    }
  },
  "require-dev": {
    "phpro/grumphp": "^0.11.6",
    "phpmd/phpmd": "^2.6",
    "phpunit/phpunit": "5.7.21",
    "nikic/php-parser": "^3.0",
    "sebastian/phpcpd": "^3.0",
    "povils/phpmnd": "^1.1",
    "squizlabs/php_codesniffer": "^3.0",
    "jakub-onderka/php-parallel-lint": "^0.9.2",
    "sensiolabs/security-checker": "^4.0"
  }
}

Ülaltoodud faili vaadates saate seda sõeluda järgmiselt.

1. 2 ja 3. rida kirjeldavad pistikprogrammi sisu. Need on ka teised valdkonnad selles failis, et anda rohkem teavet selle kohta, mida tuleb teha.
2. Read 4 kuni 8 on olulised, kuna need selgitavad, et me kasutame automaatseks laadimiseks PSR-4 ja et kõik failid kuuluvad ülataseme nimeruumi alla Presswareja PHP-failid on src kataloogis.
3. Read 9–18 hõlmavad kõiki eelmises seerias käsitletud faile.

Järgmisena andke terminalis järgmine käsk:

$ composer install

Ja see installib need paketid.

Aga kohustused?

Veendumaks, et nuusutate ja käsitlete kohustusi õigesti, on oluline konfigureerida GrumPHP nii, et see vaatab faile. Aga ma vaatan seda järgmises postituses.

Vahepeal on ehk hea võimalus demoplugina seadistamiseks ja ülaltoodud koodiga harjutamiseks. Selle õige seadistamine esimesel korral võib olla keeruline. Õnneks on paljusid väljundvigu väga lihtne mõista, nii et nende lahendamine on suhteliselt lihtne.