Սկսեք աշխատանքը Zinnector®-ի հետ՝ ծրագրավորողների CLI

Zinnector®-ը Zinn Digital®-ի անվճար, MIT արտոնագրով հրամանային տողի գործիքն է WordPress-ի ծրագրավորողների համար: Այն ստեղծում է կայքի կառուցվածքը, գործարկում է իրական WordPress Ձեր իսկ համակարգչում՝ առանց որևէ այլ բանի տեղադրման, բացի Node-ից — առանց Docker-ի, առանց MAMP-ի, առանց PHP-ի Ձեր PATH-ում — այնուհետև ստուգում է Ձեր կառուցածը հոսթինգի այն սլոթի հետ համեմատ, որտեղ պատրաստվում եք տեղակայել, և ուղարկում է այն: Այս ուղեցույցը Ձեզ զրոյից կհասցնի աշխատող կայքի մոտ երկու րոպեում և ցույց կտա, թե ինչ տեսք ունի հաջողված արդյունքը յուրաքանչյուր քայլում, որպեսզի իմանաք, երբ ինչ-որ բան սխալ է գնացել:

Ինչ է Ձեզ անհրաժեշտ

• Node 24 կամ ավելի նոր: Գործարկեք node --version; այն պետք է ցուցադրի v24 կամ ավելի բարձր: Տեղադրեք ընթացիկ LTS-ը nodejs.org-ից — Windows-ում winget install OpenJS.NodeJS.LTS, macOS-ում brew install node@24:
• npm, որը գալիս է Node-ի հետ: Zinnector®-ն այն օգտագործում է մեկ անգամ՝ WordPress-ի գործարկման միջավայրը (runtime) իր սեփական քեշ ներբեռնելու համար:
• git, միայն zinnector push-ի համար — տեղակայումներն իրականացվում են Ձեր ռեպոզիտորիայից:
• Docker, միայն եթե պահանջեք այն --runtime docker-ով: Լռելյայն գործարկման միջավայրը ոչինչ չի պահանջում:

Ստորև նշվածներից ոչ մեկի համար հաշիվ անհրաժեշտ չէ: API բանալի պահանջվում է միայն այն ժամանակ, երբ հասնում եք հոսթինգի սլոթին, Տեղակայում Zinnector®-ով բաժնում:

Քայլ 1 — տեղադրեք այն

npm install -g zinnector

Եթե npm-ը ցուցադրում է npm WARN EBADENGINE, Ձեր Node-ն ավելի հին է, քան փաթեթի պահանջած >=24.18.1-ը: Տեղադրումն ամեն դեպքում ավարտվում է, բայց CLI-ն կհրաժարվի աշխատել: Նախ թարմացրեք Node-ը, ապա նորից տեղադրեք:

Քայլ 2 — ստուգեք տարբերակը

zinnector --version

Հաջողություն. տարբերակի համար, օրինակ՝ 0.1.2: Եթե տեսնում եք "Zinnector® needs Node 24 or newer — this is Node 20.x", երկուական ֆայլը (binary) տեղադրված է, բայց Ձեր Node-ը չափազանց հին է. հրամանն ավարտվում է 78 կոդով՝ առանց որևէ գործողություն կատարելու:

Քայլ 3 — կարդացեք օգնությունը

zinnector --help

Հաջողություն. գործընթացի հինգ հրամանները նշող վահանակ (new, dev, link, check, push), իսկ այնուհետև յուրաքանչյուր հրաման՝ մեկ տողանոց նկարագրությամբ: Յուրաքանչյուր հրաման ունի նաև իր --help-ը — zinnector dev --help-ը թվարկում է գործարկման միջավայրի, PHP-ի և դարպասի (port) դրոշակները: Ամբողջական ցանկը՝ օրինակներով, գտնվում է հրամանների տեղեկատուում:

Քայլ 4 — ստեղծեք կայքի կառուցվածքը

zinnector new my-site

Հաջողություն. Created my-site վերնագիր և գրված ֆայլերի ցանկ — zinnector.json, wp-content ծառ plugins/, themes/ և mu-plugins/ օժանդակ ֆայլով, .gitignore և README — որին հաջորդում են գործարկման ենթակա հաջորդ հրամանները: Դրանում ոչինչ փոխարինիչ (placeholder) չէ. նախագիծը գործարկվում է այնպես, ինչպես կա: --template plugin-ը կամ --template theme-ը ստեղծում են փլագինի կամ բլոկային թեմայի կառուցվածքը, որն ակտիվանում է ստեղծվելու պահին:

Քայլ 5 — գործարկեք այն

cd my-site
zinnector dev

Առաջին անգամ Zinnector®-ը մեկ անգամ հարցնում է նախքան WordPress-ի գործարկման միջավայրը ներբեռնելը — մոտ 570 ՄԲ, քանի որ այն պարունակում է PHP-ի յուրաքանչյուր տարբերակ 5.2-ից մինչև 8.5 — իր սեփական քեշի թղթապանակում, երբեք ոչ Ձեր նախագծում: Պատասխանեք Y կամ փոխանցեք --yes՝ հարցը բաց թողնելու համար: Node 26 կամ ավելի նոր տարբերակներում այն նաև ներբեռնում է Node 24 միայն գործարկման միջավայրի համար (մոտ 30 ՄԲ, ստուգված nodejs.org-ի ստուգիչ գումարներով), քանի որ գործարկման միջավայրի բնիկ մոդուլն ունի նախապես կառուցված երկուական ֆայլեր միայն Node 24-ի և 25-ի համար. Ձեզ կոմպիլյատոր կամ Visual Studio անհրաժեշտ չէ:

Հաջողություն. բլոկ, որը նշում է նախագիծը, PHP-ի տարբերակը և WordPress-ի տարբերակը, ապա՝

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Քայլ 6 — բացեք այն

Զննարկիչում այցելեք http://127.0.0.1:9400: Հաջողություն. WordPress-ի նոր կայք՝ My WordPress Website վերնագրով, որը մատուցվում է Ձեր պահանջած PHP տարբերակով: http://127.0.0.1:9400/wp-admin-ը բացում է կառավարման վահանակն արդեն մուտք գործած վիճակում: Գցեք փլագին wp-content/plugins/-ի մեջ կամ թեմա wp-content/themes/-ի մեջ, և այն հասանելի կլինի հաջորդ վերաբեռնման ժամանակ — գործարկման միջավայրն այդ թղթապանակները մատուցում է անմիջապես Ձեր նախագծից:

Սեղմեք Ctrl-C՝ դադարեցնելու համար: zinnector dev --once-ը գործարկում է գործարկման միջավայրը, ցուցադրում է այն, ինչ փաստացի աշխատում է (PHP-ի տարբերակ, WordPress-ի տարբերակ, բեռնված ընդլայնումներ) և դադարեցնում է աշխատանքը — օգտակար է, երբ խոստման փոխարեն ապացույց եք ցանկանում:

Ուր գնալ հաջորդիվ

• Տեղային մշակում zinnector dev-ով — երկու գործարկման միջավայրերը, PHP-ի և WordPress-ի տարբերակների ընտրությունը, և թե ինչ որտեղից է մատուցվում:
• Տեղակայում Zinnector®-ով — մուտք գործեք, կապեք նախագիծը սլոթի հետ, նախապես ստուգեք, ուղարկեք:
• Հրամանների տեղեկատու — յուրաքանչյուր հրաման, դրոշակ և օրինակ:
• Խնդիրների լուծում — սխալները, որոնց մարդիկ իրականում հանդիպում են, և դրանցից յուրաքանչյուրի լուծումը:

Նույն փաստաթղթավորումն առկա է փաթեթի README-ում npm-ում և GitHub-ում, որտեղ խնդիրների ներկայացումը (issues) և փոփոխությունների առաջարկները (pull requests) ողջունվում են: