WordPress සංවර්ධකයන් අතර බොහෝ වෙලාවේ WP‑CLI භාවිතා කරමින් ප්ලගින් ලැයිස්තු ගන්නා විට PHP 8.2 හි Deprecated පණිවුඩ පෙනෙයි. මේ පණිවුඩවලින් කාර්ය සාධනය අඩුවීමත්, JSON ආකාරයේ දත්ත විග්රහය අසීරු වීමත් සිදු වේ. පසුගිය ලිපියක WP_CLI_PHP_ARGS මගින් error_reporting සකස් කිරීමේ ත්රි‑ස්තර ආරක්ෂාවක් හඳුන්වා දී තිබුණද, Xserver වැනි පරිසරයක එය ක්රියා නොකරන නව ගැටලුවක් හමුවුනා.
ගැටලුවේ සාරාංශය
Xserver හි /usr/bin/wp ෆයිලය phar ගොනුවක් වන අතර, එය #\!/usr/bin/env php shebang එකෙන් ආරම්භ වේ. Shell → /usr/bin/wp → env → php → phar → WP‑CLI යන ක්රමයෙන් PHP සෘජුවම ආරම්භ වන බැවින් WP_CLI_PHP_ARGS හි -d ඩ්රැග් PHP වෙත පවරා නොදේ. ඒ නිසා Deprecated ඉඟීම් පෙනෙයි.
වෙහෙසට පත් වීමේ හේතුව
WP‑CLI පළමු වරට wp plugin list --format=json වැනි විධානයක් ධාවනය කරන විට, PHP සෘජුවම phar ගොනුවෙන් ආරම්භ වන බැවින් error_reporting පරාමිතිය අතුරුදන් වේ. ප්රතිඵලයක් ලෙස 400+ Deprecated පේළි stdout හි පෙනෙයි, JSON පාර්සර් ඒවා නිසා අසාර්ථක වේ.
තූන්‑පියවරේ නිවැරදි කිරීම
v1.6.8 නව සංස්කරණයේ මෙම ගැටලුව සම්පූර්ණයෙන්ම විසඳා ඇත. ප්රධාන තීරුවලින් ත්රි‑පියවරේ වැඩපිළිවෙළක් අනුගමනය කරයි:
- පිලර් A – php‑direct මාර්ගය හඳුනා ගැනීම: wp_cli_path පරීක්ෂා කර, එය php, php8.2, php82 වැනි නාමයක් නම්
-d error_reporting='E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED'ඩ්රැග් එක PHP බයිනරි පසු පුරවා දේ. - පිලර් B – JSON කොටස පිරිසිදු කිරීම: stdout හි පළමුවැනි '[' හෝ '{' සහ අන්තිම ']' හෝ '}' අතර ඇති අක්ෂර පමණක් ගෙන,
json.loadsහරහා පාර්ස් කරයි. මෙය notice, warning වැනි අනවශ්ය පණිවුඩවලින් JSON පාර්සිං වැරදි වීමෙන් බේරේ. - පිලර් C – Windows / Linux පාරිසරික අනුව පථය සකස් කිරීම:
os.path.basenameභාවිතයෙන් '/' සහ '\' දෙකම හඳුනා ගනිමින්, ක්රොස්‑ප্লැට්ෆෝම් අනුකූලතාවය රැකේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ WordPress සංවර්ධකයන්, විශේෂයෙන් Xserver හෝ අනෙකුත් Shared Hosting සේවාදායකයන්, මෙම නව fix එකෙන් ප්රතිලාභ ලබයි. Deprecated ඉඟීම් නොපෙනීම නිසා:
- ප්ලගින් ලැයිස්තු ගැණුම වේගවත් වේ, නිෂ්පාදන පරිසරයේ CI/CD පයිප්ලයින්ස් ස්ථාවර වේ.
- JSON ආකාරයේ output නිවැරදිව ලැබෙන බැවින්, ස්වයංක්රීය පරීක්ෂණ, data‑migration, API integration වැනි වැඩේන් දෝෂ රහිතව සිදු කළ හැක.
- සිංහල UI සහ දේශීය පරිශීලකයන්ට තාක්ෂණික ගැටළු අඩු කර, ඉගෙනුම සහ ව්යාපාරික ප්රතිදානය වැඩි වේ.
නිගමනය
WP‑CLI හි Deprecated පණිවුඩයන්ට මුහුණ දෙන සැම සංවර්ධකයෙකුට v1.6.8 නව සංස්කරණය අනිවාර්යයි. එය shebang‑based phar ක්රමයද, JSON පාර්සිං දෝෂද සාර්ථකව නිරාකරණය කරයි. ඉදිරි කාලයේ WordPress‑CLI භාවිතය තවත් නිරවද්ය හා කාර්යක්ෂම වනු ඇත.
