සංවර්ධක CLI එකක් වන Zinnector® භාවිතය ආරම්භ කිරීම

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

ඔබට අවශ්‍ය දේ

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

පහත දක්වා ඇති කිසිදු පියවරකට ගිණුමක් අවශ්‍ය නොවේ. API කේතයක් අවශ්‍ය වන්නේ ඔබ හෝස්ටින් ස්ලොට් එකක් වෙත ළඟා වූ විට, Deploying with 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" ලෙස දකින්නේ නම්, බයිනරිය ස්ථාපනය කර ඇතත් ඔබේ Node සංස්කරණය ඉතා පැරණිය; අණසක මඟින් කිසිවක් කිරීමට පෙර code 78 සමඟ නික්මෙයි.

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

zinnector --help

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

පියවර 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

පළමු වතාවේදී, Zinnector® විසින් WordPress runtime එක බාගත කිරීමට පෙර එක් වරක් අසනු ලබයි — මෙයට 5.2 සිට 8.5 දක්වා සෑම PHP බිල්ඩ් එකක්ම ඇතුළත් වන බැවින් එය මෙගාබයිට් 570 ක් පමණ වේ — මෙය ඔබේ ව්‍යාපෘතියට නොව එහිම හැඹිලි නාමාවලියට (cache directory) බාගත වේ. Y ලෙස පිළිතුරු දෙන්න, නැතහොත් ප්‍රශ්නය මඟ හැරීමට --yes ලබා දෙන්න. Node 26 හෝ ඊට වඩා අලුත් සංස්කරණවලදී, එය runtime එක සඳහා පමණක් Node 24 එකක් ද ලබා ගනී (මෙගාබයිට් 30 ක් පමණ, nodejs.org හි checksums වලට එරෙහිව තහවුරු කර ඇත), මන්ද runtime හි native module එක සතු වන්නේ Node 24 සහ 25 සඳහා පමණක් වූ prebuilt binaries වන බැවිනි; ඔබට කොම්පයිලරයක් හෝ 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/ වෙත ඇතුළත් කරන්න, ඊළඟ රීලෝඩ් කිරීමේදී එය එතැන තිබෙනු ඇත — runtime එක මඟින් එම නාමාවලියන් ඔබේ ව්‍යාපෘතියෙන්ම කෙලින්ම සපයයි.

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

ඊළඟට යා යුතු ස්ථාන

• Local development with zinnector dev — runtimes දෙක, PHP සහ WordPress සංස්කරණ තේරීම, සහ කොතැනින් කුමක් සපයන්නේද යන්න.
• Deploying with Zinnector® — ඇතුළු වන්න, ව්‍යාපෘතිය ස්ලොට් එකකට සම්බන්ධ කරන්න, පූර්ව පරීක්ෂාව සිදු කරන්න, යොමු කරන්න.
• The command reference — සෑම අණසකක්ම, flag එකක්ම සහ උදාහරණයක්ම.
• Troubleshooting — පාරිභෝගිකයින්ට සැබවින්ම මුහුණ දීමට සිදු වන දෝෂ සහ ඒ එක එකකට ඇති විසඳුම්.

මෙම ලේඛනගත කිරීම්ම npm හි සහ GitHub හි පැකේජයේ README හි ද ඇත, එහි ගැටලු (issues) සහ pull requests සාදරයෙන් පිළිගනු ලැබේ.