Tovább a tartalomhoz

Visual Studio Code WordPress-fejlesztéshez

A Visual Studio Code beállítása WordPress-fejlesztéshez: telepítés, a PHP-hoz, a hibakereséshez, a Bladehez és a frontendhez ajánlott bővítmények, projektbeállítások és távoli munka.

A Visual Studio Code (VS Code) a Microsoft ingyenes, nyílt forráskódú kódszerkesztője. Önmagában is jó szerkesztő, a bővítményekkel pedig PHP-, WordPress-, Blade- és frontendfejlesztésre is alkalmassá teszed. Van beépített Git-támogatása és beépített terminálja is.

VS Code egy HTML-projekttel: az Explorer a bal oldalon, a szerkesztő középen

Töltsd le a code.visualstudio.com oldalról Windowsra, macOS-re vagy Linuxra. Parancssorból:

Terminál (macOS, Homebrew)
brew install --cask visual-studio-code
Terminál (Linux, Snap)
sudo snap install --classic code

Debian- és Ubuntu-alapú rendszeren a letöltött .deb csomagot az sudo apt install ./<fájl>.deb parancs telepíti, ami az apt-tárat is felveszi, így a szerkesztő a rendszer csomagkezelőjével frissül.

Ha a terminálból a code paranccsal akarod indítani, macOS-en a Parancspalettán (Cmd+Shift+P) keresd a Shell Command szóra, és futtasd az Install ‘code’ command in PATH parancsot. Windowson és Linuxon a telepítő ezt elintézi. Ezután:

Terminál
code . # az aktuális mappa megnyitása
code --diff fajl1.php fajl2.php

A bővítményeket a bal oldali Extensions nézetből telepítheted (Ctrl+Shift+X), az azonosítóra keresve.

Mire Bővítmény Azonosító
PHP-kódkiegészítés, definícióra ugrás PHP Intelephense bmewburn.vscode-intelephense-client
Lépésenkénti PHP-hibakeresés PHP Debug xdebug.php-debug
PHPCS-szabályok szerinti ellenőrzés és javítás PHP Sniffer & Beautifier ValeryanM.vscode-phpsab
Blade-sablonok formázása Laravel Blade formatter shufo.vscode-blade-formatter
Tailwind-osztályok kiegészítése Tailwind CSS IntelliSense bradlc.vscode-tailwindcss
JavaScript ellenőrzése ESLint dbaeumer.vscode-eslint
Kódformázás Prettier esbenp.prettier-vscode
Egységes behúzás a csapatban EditorConfig editorconfig.editorconfig
Git-előzmények soronként GitLens eamodio.gitlens

Parancssorból: code --install-extension bmewburn.vscode-intelephense-client.

Az Intelephense a PHP saját függvényeit ismeri, a WordPressét nem. Két megoldás van: ha a WordPress-mag a megnyitott mappában van (például Bedrock web/wp mappája), az Intelephense bejegyzi. Ha nincs, vedd fel a deklarációs csomagot:

Terminál
composer require --dev php-stubs/wordpress-stubs

Az Intelephense a vendor/ mappa csomagjait is indexeli. WooCommerce-hez létezik a php-stubs/woocommerce-stubs csomag.

A PHP Debug bővítmény alapból a 9003-as porton figyel. A .vscode/launch.json fájlba:

.vscode/launch.json
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html": "${workspaceFolder}"
}
}
]
}

A pathMappings a szerver (vagy konténer) útvonalát köti a gépeden lévő mappához. A bal oldal a szerveren lévő útvonal, DDEV-nél ez a /var/www/html. Indítsd el a figyelést (Run → Start Debugging), tegyél egy töréspontot, és nyiss meg egy oldalt. A beállítás részleteit a DDEV oldalunk is tárgyalja. Ha a töréspont nem aktivál, a bővítmény leírása szerint kapcsold be a "log": true beállítást a launch.json-ban, és nézd a Debug Console nézetet.

A projekt .vscode/settings.json fájlja csak arra a mappára vonatkozik, és Gittel megosztható a csapattal:

.vscode/settings.json
{
"editor.formatOnSave": true,
"files.exclude": {
"**/node_modules": true
},
"search.exclude": {
"**/vendor": true,
"**/node_modules": true
},
"[blade]": {
"editor.defaultFormatter": "shufo.vscode-blade-formatter"
},
"files.associations": {
"*.blade.php": "blade"
}
}

A PHP Sniffer & Beautifier a projekt Composerrel telepített phpcs és phpcbf programját magától megtalálja, ha a gyökérben van composer.json és composer.lock. Ruleset-nek a projekt phpcs.xml.dist fájlját használja (lásd PHP_CodeSniffer és WPCS).

A Blade-hez használt témáról a Sage oldal ír.

Ha egy bővítményt és egy témát együtt fejlesztesz, a File → Add Folder to Workspace paranccsal egy ablakba teheted őket, és a File → Save Workspace As paranccsal .code-workspace fájlba mentheted.

  • Remote - SSH (ms-vscode-remote.remote-ssh): a szerveren lévő mappát nyitod meg, mintha helyi lenne.
  • Dev Containers (ms-vscode-remote.remote-containers): Dockerben futó fejlesztői környezet.

Élesen futó oldal fájljait ne szerkeszd kézzel: a változás menjen Gitbe, és onnan a szerverre.

Parancs Windows és Linux macOS
Parancspaletta Ctrl+Shift+P Cmd+Shift+P
Fájl gyors megnyitása Ctrl+P Cmd+P
Keresés a fájlokban Ctrl+Shift+F Cmd+Shift+F
Terminál Ctrl+` Ctrl+`
Következő előfordulás kijelölése (több kurzor) Ctrl+D Cmd+D
Definícióra ugrás F12 F12

A teljes listát a Help → Keyboard Shortcut Reference menüpont adja.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások