# Te Whakamahi i te WP-CLI mō tō Pae WordPress

Source: https://support.kapsulehost.com/mi-nz/wordpress-wp-cli

KPanel kei roto ko tētahi pānui WP-CLI e whakahaere ana i ngā whakahau ki tō pae WordPress mai i te pūtirotiro, kāore he kiritaki SSH me te kore takiuru pūtuma. Ka hipokina e tēnei aratohu te wāhi e kitea ai, ko ēhea tonu ngā whakahau kua whakaaetia me te take, ngā pokatata kua hangaia ki roto i te mata, me ngā mahi me whakatutuki ina hiahia koe ki tētahi mea kāore e whakahaerehia e te pānui.

## Te Whakatuwhera i te Pānui

1. Takiuru ki [KPanel](https://kpanel.kapsulehost.com) ka pāwhiri ai i te **Ngā Paetukutuku** kei te tapa maui.
2. Pāwhiri i tō pae WordPress.
3. Whakatuwherahia te tapa **WordPress**, kātahi te wāhanga **Console**.

![WP-CLI console on a WordPress site in KPanel](https://support.kapsulehost.com/help/screenshots/wordpress-wp-cli.c3f61741.webp)

Kua tīmata kē te whakaurunga ki tētahi `wp` pūmau, nō reira ko ngā kupu i muri mai anake e tāuru ai koe. `plugin list`, ehara i te `wp plugin list`. Pāwhiritia te Enter, i te pāwhiri rānei i te **Run**.

> **Note:** Ko **Console** tētahi o ngā wāhanga e puta ana i ngā mahere whakahaeretia. I ngā mahere kē atu ka mutu te rārangi tapa ki tētahi hononga **+8 on Managed**. Ko ia mahi kua whakamāramatia i konei ehara i te whakahau mata, he pātene ōrite tōna i tētahi atu wāhi o KPanel, nō reira kāore tētahi mea e kore e taea: he huarahi tere ake te pānui ki te pūkaha kotahi anō.

Ka rere ngā whakahau hei kaiwhakamahi pūnaha ake o tō pae, i roto tonu i te kōpaki o tō pae. Kāore e taea e rātou te kite, te pā rānei ki tētahi atu pae.

## Ngā Mea E Whakahaerehia Ana me Ngā Mea Kāore E Whakahaerehia Ana e te Pānui

Ka whakamahia e te pānui tētahi rārangi whakaaetanga. Ko ngā kūmuri whakahau kei raro nei anake kua whakaaetia, ā, ko tētahi atu mea ka whakakorea i mua i tōna taenga ki te tūmau, me tētahi karere e tapa ana i te whakahau i whakakorehia.

| Wāhi | Kua Whakaaetia |
|---|---|
| Core | `core version`, `core check-update`, `core update`, `core is-installed`, `core verify-checksums` |
| Plugins | `plugin list`, `plugin update`, `plugin install`, `plugin activate`, `plugin deactivate`, `plugin status`, `plugin get`, `plugin delete`, `plugin verify-checksums` |
| Themes | `theme list`, `theme update`, `theme install`, `theme activate`, `theme status`, `theme get`, `theme delete` |
| Users | `user list`, `user get`, `user create`, `user update`, `user set-role`, `user delete`, `user reset-password`, `user add-cap`, `user remove-cap`, `user generate` |
| Database | `db size`, `db tables`, `db optimize`, `db repair`, `db check` |
| Cache me ngā transient | `cache flush`, `cache get`, `cache set`, `cache add`, `cache delete`, `transient get`, `transient set`, `transient delete` |
| Ngā ture rewrite | `rewrite flush`, `rewrite list`, `rewrite structure` |
| Cron | `cron event list`, `cron event run`, `cron schedule list` |
| Whirihoranga | `config get`, `config list`, `config has`, `config shuffle-salts` |
| Aratau whakahaere | `maintenance-mode activate`, `maintenance-mode deactivate`, `maintenance-mode status` |
| Tirotiro pānui anake | `option get`, `option list`, `post list`, `post get`, `comment list`, `comment get` |
| Pāpāho me te reo | `media regenerate`, `language core install`, `language core update` |
| Rapu me te whakakapi | `search-replace` |

Ko ngā whakakorenga ā-whakaaro he mea nui ake i ngā whakaurunga:

- **`eval` me `shell`** kua whakakorea. Mā te PHP noa me te anga pūtirotiro noa e rite ai te pānui ki tētahi tūranga pakeke i roto i te ripa pūtirotiro.
- **`db import`, `db export`, `db drop`, `db query` me `db reset`** kua whakakorea. Ka whakangaro te kawemai me te tautuku i tētahi pūkete raraunga, kāore he wāhanga whakaūnga; ko `db query` he mata SQL kāore he here. Whakamahia ake te phpMyAdmin: [Te Uru atu ki Tō Pūkete Raraunga mā te phpMyAdmin](https://support.kapsulehost.com/mi-nz/sites-phpmyadmin).
- **`config set` me `config delete`** kua whakakorea. Mā tētahi tuhinga `wp-config.php` kino e noho mutu ai te pae. Pānuihia ngā uara i konei, whakarerekētia mā te kaiwhakahaere kōnae.
- **`option update` me `option delete`** kua whakakorea. He huarahi noa te whakarerekē kōwhiringa matapō hei pakaru i tētahi pae kia kore e taea te whakatika.

> **Warning:** Kāore te pānui e tango i tētahi tāpiri haumaru māu, ahakoa he aha te whakahau. Ko ngā pātene kei te wāhanga **Ngā Mahi Tere** anake e mahi pērā ana. I mua i te `search-replace`, `core update`, `plugin update`, `theme update`, `db optimize`, `db repair` rānei, tangohia tētahi tāpiri haumaru māu anō mai i te whārangi **Tuku Kōpī** o te pae. Tirohia [Te Tango i Tētahi Tāpiri Haumaru](https://support.kapsulehost.com/mi-nz/taking-a-backup).

## Te Mahi i roto i te Pānui

He nui ake ngā mahi a te mata i te whakaae kotahi whakahau i te wā kotahi.

**Ngā pātene kua rite kē.** Kei runga ake i te pōro ngā pokatata kua whakarōpūtia: Performance (horoi cache, whakawātea transients, whakatutuki rewrites, tirotiro autoload), Database (whakapai, tirotiro, whakatika, rahi), Diagnostics (putanga WP, tirotiro whakahōu, whakamana core, ngā kaupapa cron), Content (rārangi plugins, kaupapa, kaiwhakamahi, whakahaere cron ināianei), Security (kaiwhakahaere pū, checksums plugin, tautuku salts, wp-config) me Maintenance (aratau whakahaere kā me moti, whakahou whakaahua iti, tūnga). Kotahi te pāwhiri hei whakahaere i te whakahau.

**Hītori.** Pāwhiritia ngā pere whakarunga me te whakararo kei te pōro hei neke i ngā whakahau 50 whakamutunga āu mō tēnei pae.

**Ngā kongakonga tuhinga.** Pāwhiritia te tohu tohutoro i te taha o tētahi whakahau hei tiaki i a ia me tētahi ingoa, kia kotahi anake te pāwhiri ā muri ake mō tētahi karanga roa ka whakamahia e koe ia marama.

**Kāri taiao.** Kei runga ake i te pōro, ka whakaatu tētahi kāri i te putanga PHP, te putanga WordPress, te rohe maharatanga, te maharatanga e whakamahia ana ināianei, te mōrahi tukunga atu me te rohe wā whakahaere o te pae, me tētahi pātene **Kape mō te tautoko** e tuku ana i ēnei katoa me tō rārangi plugin hohe ki te papatopaka. Whakauruhia tērā ki tētahi tiikete tautoko, kua tiakina e koe tētahi hokinga.

**Kape putanga.** He pātene kape me te pātene whakakore kei ia poraka putanga.

Ka rere mai te putanga i a ia e whakahaeretia ana te whakahau, nō reira ka whakaatuhia te ahunga whakamua mō tētahi mahi roa, kaua e noho pū noa.

## Ngā Whakahau e Tika Ana Kia Mōhio

### Te Mātai

```
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
```

Ka whakataurite `verify-checksums` i ō kōnae core me plugin ki ngā kape whakaputanga mana, ā, ka pūrongo i ngā mea kua whakarerekētia. Koinei te tirohanga tuatahi tere ake mō tētahi pae e whakapaetia ana kua pāngia.

Ka whakarārangi `option list --autoload=yes` i ngā kōwhiringa katoa e uta ana a WordPress i ia tono takitahi. Ko tētahi o ngā take e kaha kitea ai mō tētahi pae puhoi, kāore he take e kitea ana, he ripanga autoload kua kīkī rawa.

### Te Tiaki Whare

```
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
```

### Ngā Kaiwhakamahi

```
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
```

Ko ngā mea katoa ka tāuruhia ki konei ka tuhia ki te rangitaki hohe o tō pūkete, tae atu ki ngā kupuhipa. Whakarerekētia tētahi kupuhipa i whakaritea e koe pēnei ina oti tō takiuru. Ko ngā taipitopito katoa mō te whakahoki anō i te pūkete kei [Te Tautuku anō i tētahi Kupuhipa Whakahaere WordPress kua Ngaro](https://support.kapsulehost.com/mi-nz/wordpress-reset-password).

### Te Rapu me te Whakakapi

```
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
```

Me whakahaere tuatahi tonu i te oma mātai. Ko te ara whakaako katoa, tae atu ki te take ka whakangaro ai tētahi whakakapi SQL mata i tētahi pūkete raraunga WordPress, kei [Te Whakahaere i tētahi Rapu me te Whakakapi](https://support.kapsulehost.com/mi-nz/wordpress-search-replace).

## Console rānei, Quick Actions rānei?

E rua e whakahaere ana i te WP-CLI ōrite i raro. Kōwhiria mā tēnei tūāpapa:

| Mahi | Huarahi Pai Ake |
|---|---|
| Horoi cache, whakahōu plugins, whakahou pāpāho | **Ngā Mahi Tere**, kotahi te pāwhiri, ā, ka tāpiri haumaru i te tuatahi |
| Rapu me te whakakapi me tētahi arokite mā te ripanga | **Ngā Mahi Tere**, te kāri Search & Replace |
| Tētahi mea e hiahia ana ki tētahi haki motuhake | Console |
| Te whakarārangi, te tirotiro, te mātai | Console |
| Te whakahaere i tētahi kaupapa cron kua roa rawa | Console |
| Te whakatika i te `wp-config.php`, te kawemai rānei i tētahi pūkete raraunga | Ehara i tētahi o ēnei. Whakamahia te kaiwhakahaere kōnae, te phpMyAdmin rānei |

## Ina Hiahia Koe i Tētahi Mea Nui Ake i te Rārangi Whakaaetanga

Mō te WP-CLI kore here, hono mā SSH ka whakahaere tika ai i te `wp` mai i te kōpaki o tō pae. Ka whakamahi te SSH i te motuhēhēnga kī anake, nō reira tāpirihia tō kī tūmatanui i te tuatahi mai i te **Tautuhinga** o te pae, kātahi ko te tapa **Ngā Kī SSH**. Kei taua mata anō ngā taipitopito hononga, tae atu ki te host tika, te tauranga me te ingoa whakamahi. Tirohia [Te Tāpiri i Ngā Kī SSH](https://support.kapsulehost.com/mi-nz/adding-ssh-keys) me [Te Hono mā SFTP](https://support.kapsulehost.com/mi-nz/sftp-access).

## Te Whakatika Raru

**"'x y' is not in the allowed command list."** Kāore te whakahau kei roto i te rārangi whakaaetanga. Tirohia te ripanga i runga ake mō te ōrite tata kua whakaaetia, whakamahia rānei te SSH.

**"No results returned. Check that WP-CLI is available."** I oma te whakahau engari kāore i tā i tētahi mea. Ko te tikanga nui tēnei mō tētahi uiuinga kāore he putanga ōrite.

**Ka mutu te wā mō te whakahau.** Kua herea ngā whakahau pānui ki te 60 hēkona. Ko ngā mahi roa pērā i te whakahou anō i tētahi whare pūkete pāpāho nui me whakahaere mai i **Ngā Mahi Tere**, e whakamahi ana i tētahi rohe wā roa ake, mā te SSH rānei.

**Kāore he mea e oma ana, ā, kua monoa ngā pātene.** He pānui anake te tūranga pūkete KapsuleHost mō tēnei pae. Tonoa tētahi rangatira pūkete kia whakanekehia ake.