Parempi WordPress-koodi: säveltäjän lukitustiedosto
Ennen kuin lopetamme keskustelumme Composerista, meillä on vielä yksi tärkeä asia keskusteltavana: toimittajahakemisto (ja laajennukselta myös Composer-lukkotiedosto).
Erityisesti meidän on puhuttava siitä, miksi meidän ei tarvitse sitoa toimittajahakemistoa arkistoon, mutta kuinka avustajamme voivat olla varmoja siitä, että heillä on uusin versio ohjelmistosta, joka tarvitaan toimimaan koodipohjamme kanssa.
Koodin laatutyökalujen käyttäminen paremman WordPress-koodin kirjoittamiseen on kyllä tärkeää, mutta myös riippuvuuksien ja arkiston hallinnan ymmärtäminen on tärkeää. Joten ennen kuin tarkastelemme mainittuja apuohjelmia, tarkastellaan lukitustiedostoa, sen roolia ja miksi meidän ei tarvitse sitoa toimittajahakemistoa arkistoon.
Parempi WordPress-koodi säveltäjän lukitustiedostolla
Ne, jotka työskentelevät WordPressin kanssa – ja ehkä muissa PHP-pohjaisissa kehyksissä ja perustaissa (en todellakaan tiedä, koska en yleensä työskentele niiden kanssa) – luottavat Composeriin, mikä on hyvä asia.
Tämä voi myös johtaa siihen, että halutaan sitoa koko toimittajahakemiston lähdehallinta, mikä ei ole hyvä asia.
Kuten edellisessä viestissä mainittiin :
En suosittele myyjähakemiston tarkistamista arkistoon. Siitä voi myöhemmin tulla valtava hakemisto, ja se voi heikentää Composerin koko tarkoitusta.
Joten kuinka voimme varmistaa, ettemme sido tiedostoja tarpeettomasti (ja siten lisää arkistomme kokoa) arkistoon samalla kun varmistamme, että avustajamme käyttävät samaa ohjelmistoversiota kuin me?
Halu sitoutua myyjähakemistoon
Ne teistä, jotka ovat käyttäneet Composeria ja tietävät ainakin toimittajahakemiston, olet todennäköisesti tottunut näkemään useita asennettujen riippuvuuksien hakemistoja.
Ja ne ovat hyödyllisiä; muuten et olisi sisällyttänyt niitä, eikö niin?
Mutta tässä on asia toimittajahakemistosta : vaikka sinulla olisi vain muutama riippuvuus asennettuna projektiisi, itse tiedostokoko voi olla suuri. Ja tämä voi olla vielä suurempi, kun sinulla on paljon riippuvuuksia.
Siitä huolimatta tämän sitominen lähteen hallintaan näyttää järkevältä, eikö? Haluamme varmistaa, että kaikilla on sama ohjelmistoversio, jota käytämme, ja haluamme varmistaa, että heidän ei tarvitse olla tekemisissä Composerin kanssa.
On kuitenkin toinenkin tapa. Ja se pitää arkistomme pienenä varmistaen samalla, että riippuvuutemme versiot pidetään synkronoituna niiden kanssa, jotka kloonaavat arkiston, sitoutuvat arkistoon tai minkä tahansa jatkuvan integroinnin apuohjelman, joka käyttää arkistoa.
Lukitustiedoston ymmärtäminen
Ennen kuin puhun toimittajahakemistosta, haluan koskettaa toista tärkeää Composer-näkökohtaa: lukkotiedostoa. Eli jos suoritat asennus- tai päivityskomennon päätteessäsi, näet lukkotiedoston, joka luodaan yhdessä toimittajahakemiston kanssa .
Mikä tämä tiedosto on?
Edellisessä viestissä oli esimerkkimääritystiedosto. Yksi asia, jonka tämän tiedoston avulla voimme myös tehdä, on määrittää kolmannen osapuolen kirjastot tai riippuvuudet, joita voimme käyttää projekteissamme.
Olen puhunut tästä muissa viesteissä (ja voimme tarkastella tätä hieman myöhemmin tässä sarjassa). Mutta tässä lukitustiedosto tulee peliin.
Lyhyesti sanottuna lukitustiedosto sisältää aina tiedot niiden riippuvuuksien versiosta – tarkan version –, joita käytetään projektin kanssa, kun asennus tai päivitys viimeksi suoritettiin.
Kun Composer on suorittanut asennuksen, se kirjoittaa kaikki lataamansa paketit ja niiden tarkat versiot composer.lock-tiedostoon lukiten projektin kyseisiin versioihin.
Sinun tulee sitoa composer.lock-tiedosto projektivarastoon, jotta kaikki projektin parissa työskentelevät ihmiset ovat lukittuina samoihin riippuvuuksien versioihin (lisätietoja alla).
Tavoitteena on varmistaa, että jokaisella on käytössä sama versio projektin riippuvuuksista – ei vanhempia tai uudempia versioita – mutta sama versio.
Joten kun suoritat säveltäjän asennusta, kun arkistoon sisältyy lukitustiedosto, se käyttää lukkotiedostossa määritettyä ohjelmistoversiota.
Ja tämä varmistaa, että kaikki käyttävät samaa versiota kustakin riippuvuudesta, ja näin voidaan estää tarve sitoa toimittajahakemisto lähdehallintaan.
Korkeamman laatukoodin kirjoittaminen
Joten minne tästä lähdetään?
Nyt kun ymmärrämme kuinka käyttää Composeria ja kuinka käyttää lukitustiedostoa, voimme alkaa puhua todellisista riippuvuuksista, jotka auttavat parantamaan koodimme laatua.
Ja kun puhumme korkealaatuisemman koodin kirjoittamisesta, on apuohjelmia, jotka on tehty juuri sitä varten. Joten seuraavissa viesteissä aiomme tarkastella joitain niistä.