සංවර්ධක CLI වන Zinnector® සමඟින් ආරම්භ කිරීම

Zinnector® යනු WordPress සංවර්ධකයන් සඳහා වන Zinn Digital® හි නොමිලේ ලබා දෙන, MIT-බලපත්‍රලාභී විධාන පේළි මෙවලමකි (command-line tool). එය වෙබ් අඩවියක මූලික සැකිල්ල සකසයි, Node පමණක් ස්ථාපනය කර ඇති ඔබගේම පරිගණකයේ සැබෑ WordPress ධාවනය කරයි — කිසිදු Docker නැත, MAMP නැත, ඔබගේ PATH හි PHP නැත — ඉන්පසු ඔබ ගොඩනැගූ දේ ඔබ යෙදවීමට (deploy) සූදානම් වන hosting slot එක සමඟ පරීක්ෂා කර එය push කරයි. මෙම මාර්ගෝපදේශය ඔබව මිනිත්තු දෙකක් වැනි කෙටි කාලයක් තුළ කිසිවක් නැති තත්ත්වයක සිට ධාවනය වන වෙබ් අඩවියක් දක්වා රැගෙන යන අතර, කිසියම් දෝෂයක් සිදුවී ඇත්දැයි ඔබට දැනගත හැකි වන පරිදි එක් එක් පියවරේදී සාර්ථක ප්‍රතිඵලය කෙබඳුදැයි ඔබට පවසයි.

ඔබට අවශ්‍ය දේවල්

• Node 24 හෝ ඊට නව සංස්කරණයක්. node --version ධාවනය කරන්න; එහි v24 හෝ ඊට ඉහළ අගයක් මුද්‍රණය විය යුතුය. nodejs.org වෙතින් වත්මන් LTS ස්ථාපනය කරන්න — Windows මත winget install OpenJS.NodeJS.LTS, macOS මත brew install node@24.
• Node සමඟ පැමිණෙන npm. WordPress ධාවන කාල පරිසරය (runtime) එහිම හැඹිලියට (cache) බාගත කිරීම සඳහා Zinnector® එය එක් වරක් භාවිත කරයි.
• zinnector push සඳහා පමණක් git — යෙදවීම් මෙහෙයවනු ලබන්නේ ඔබගේ ගබඩාවෙන් (repository) වේ.
• ඔබ --runtime docker සමඟ ඉල්ලා සිටින්නේ නම් පමණක් Docker. පෙරනිමි ධාවන කාල පරිසරයට කිසිවක් අවශ්‍ය නොවේ.

පහත සඳහන් කිසිවකට ගිණුමක් අවශ්‍ය නොවේ. Deploying with Zinnector® හිදී, ඔබ hosting slot එකක් වෙත ළඟා වූ විට පමණක් API යතුරක් අවශ්‍ය වේ.

පියවර 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" ලෙස දිස්වන්නේ නම්, බයිනරිය ස්ථාපනය කර ඇති නමුත් ඔබගේ Node ඉතා පැරණි වේ; කිසිවක් සිදු නොකර විධානය 78 කේතය සමඟ පිටවෙයි.

පියවර 3 — උපකාරක තොරතුරු කියවන්න

zinnector --help

සාර්ථකයි: කාර්ය ප්‍රවාහයේ විධාන පහ (new, dev, link, check, push) නම් කරන බැනරයක් සහ එක් එක් විධානයේ එක් පේළියේ අරමුණ. සෑම විධානයක්ම ඒ සඳහාම වූ --help ද ලබා ගනී — zinnector dev --help මඟින් ධාවන කාල පරිසරය, PHP සහ port flags ලැයිස්තුගත කරයි. උදාහරණ සහිත සම්පූර්ණ ලැයිස්තුව, විධාන විමර්ශනය හි අඩංගු වේ.

පියවර 4 — අඩවියක සැකිල්ලක් තනන්න

zinnector new my-site

සාර්ථකයි: Created my-site ශීර්ෂයක් සහ එය ලිවූ ලිපිගොනු ලැයිස්තුවක් — zinnector.json, plugins/, themes/ සහ mu-plugins/ උපකාරකයක් සහිත wp-content ව්‍යුහයක්, .gitignore එකක් සහ README එකක් — ඉන්පසු ධාවනය කිරීමට ඊළඟ විධාන. එහි ඇති කිසිවක් තාවකාලික ආදේශක නොවේ; ව්‍යාපෘතිය පවතින ආකාරයෙන්ම ආරම්භ වේ. --template plugin හෝ --template theme මඟින් ප්ලගිනයක හෝ බ්ලොක් තේමාවක සැකිල්ලක් සකසන අතර එය නිර්මාණය වූ මොහොතේම සක්‍රිය වේ.

පියවර 5 — එය ධාවනය කරන්න

cd my-site
zinnector dev

පළමු වතාවේදී, WordPress ධාවන කාල පරිසරය — PHP 5.2 සිට 8.5 දක්වා සෑම build එකක්ම රැගෙන යන බැවින් මෙගාබයිට් 570ක් පමණ — කිසි විටෙකත් ඔබගේ ව්‍යාපෘතියට නොව, එහිම හැඹිලි නාමාවලියට බාගත කිරීමට පෙර Zinnector® එක් වරක් විමසයි. Y ලෙස පිළිතුරු දෙන්න, නැතහොත් ප්‍රශ්නය මඟ හැරීමට --yes ලබා දෙන්න. Node 26 හෝ ඊට නව සංස්කරණවලදී, එය ධාවන කාල පරිසරය සඳහා පමණක් Node 24 ද ලබා ගනී (මෙගාබයිට් 30ක් පමණ, nodejs.org හි checksums වලට එරෙහිව සත්‍යාපනය කර ඇත), මන්ද ධාවන කාල පරිසරයේ native මොඩියුලයට ඇත්තේ Node 24 සහ 25 සඳහා පමණක් පූර්ව-සාදන ලද බයිනරි වේ; ඔබට compiler එකක් හෝ 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 වෙත පිවිසෙන්න. සාර්ථකයි: ඔබ ඉල්ලා සිටි PHP සංස්කරණය මඟින් සපයනු ලබන, My WordPress Website නමින් යුත් නැවුම් WordPress අඩවියක්. http://127.0.0.1:9400/wp-admin මඟින් දැනටමත් ලොග් වී ඇති පාලක පුවරුව (dashboard) විවෘත වේ. wp-content/plugins/ තුළට ප්ලගිනයක් හෝ wp-content/themes/ තුළට තේමාවක් ඇතුළත් කරන්න, එවිට ඊළඟ ප්‍රතිපූරණයේදී (reload) එය එහි තිබේ — ධාවන කාල පරිසරය එම නාමාවලි සෘජුවම ඔබගේ ව්‍යාපෘතියෙන් සපයයි.

නැවැත්වීමට Ctrl-C ඔබන්න. zinnector dev --once මඟින් ධාවන කාල පරිසරය ආරම්භ කරයි, සැබවින්ම ධාවනය වන දේ මුද්‍රණය කරයි (PHP සංස්කරණය, WordPress සංස්කරණය, පූරණය කළ දිගු) සහ නතර වේ — පොරොන්දුවකට වඩා සාක්ෂියක් අවශ්‍ය වූ විට මෙය ප්‍රයෝජනවත් වේ.

ඊළඟට යා යුතු තැන්

• zinnector dev සමඟ දේශීය සංවර්ධනය — ධාවන කාල පරිසර දෙක, PHP සහ WordPress සංස්කරණ තෝරා ගැනීම සහ කොතැනින් කුමක් සපයන්නේද යන්න.
• Zinnector® සමඟ යෙදවීම — ලොග් වන්න, ව්‍යාපෘතිය slot එකකට සම්බන්ධ කරන්න, පෙර-පරීක්ෂාව සිදු කරන්න, push කරන්න.
• විධාන විමර්ශනය — සෑම විධානයක්ම, flag එකක්ම සහ උදාහරණ.
• දෝෂ නිරාකරණය — පරිශීලකයින්ට සැබවින්ම මුහුණ දීමට සිදුවන දෝෂ සහ ඒ එක් එක් දෝෂය සඳහා පිළියම්.

ගැටලු (issues) සහ pull requests සාදරයෙන් පිළිගන්නා npm සහ GitHub හි ඇති පැකේජයේ README හි ද මෙම ලියකියවිලි අඩංගු වේ.