Cocoonの導入方法【ZIPアップロードできなかった時の対処法】

Wordpress

WordPressを立ち上げて、
テーマをCocoonにしようとしました。

でもここで問題発生。

ZIPファイルがアップロードできない。

「アップロード上限を超えています」

…出ました。

自宅Ubuntu Server + Docker構成では
よくある壁です。

今回はその解決方法をまとめます。


1. 通常のインストール方法(まずは基本)

本来の手順:

  1. Cocoon公式サイトからZIPをダウンロード
  2. WordPress管理画面
  3. 外観 → テーマ → 新規追加
  4. テーマのアップロード
  5. ZIPファイルを選択
  6. インストール

ここでエラーが出ました。


2. なぜアップロードできないのか?

原因はこれです。

PHPのアップロード上限サイズが小さい

初期状態では:

  • upload_max_filesize → 2MB
  • post_max_size → 8MB

Cocoonはそれより大きい場合があります。


3. PHPアップロード容量を増やす(Docker環境)

Dockerの場合、
php.iniを直接変更します。

まずコンテナに入ります。

docker exec -it wp1_app bash

php.iniの場所確認:

php --ini

通常は:

/usr/local/etc/php/php.ini

編集:

nano /usr/local/etc/php/php.ini

以下を変更:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M

保存後、コンテナ再起動:

docker restart wp1_app

これでアップロード可能になります。


4. それでもダメだったので直接配置した話

正直、私は面倒になって
直接テーマフォルダに入れました。

サーバー側で:

cd /var/www/html/wp-content/themes

ZIPをアップロード(SCPなど)

解凍:

unzip cocoon-master.zip

フォルダ名を整える:

mv cocoon-master cocoon

子テーマも同様に配置。

その後、

WordPress管理画面で有効化。

これで問題なく動きました。


5. アップロード上限を増やす別の方法(推奨)

docker-compose.yml に追加する方法。

environment:
PHP_UPLOAD_MAX_FILESIZE: 64M
PHP_POST_MAX_SIZE: 64M

またはカスタムphp.iniをマウント:

volumes:
- ./php.ini:/usr/local/etc/php/php.ini

これが本来は綺麗。


6. 親テーマと子テーマ両方入れる

重要。

  • cocoon
  • cocoon-child

両方入れて、

子テーマを有効化。

量産前提なら必須。


7. 実際にやって思ったこと

レンタルサーバーでは
何も考えずアップロードできます。

でも自宅サーバーは違います。

全部自分で設定する。

最初は面倒ですが、

理解は確実に深まります。


まとめ

Cocoon導入でつまずいたら:

  • PHPアップロード容量を確認
  • php.iniを修正
  • コンテナ再起動
  • 最終手段は直接配置

自宅サーバー運用では、
こういう小さな壁が成長ポイントでした。

コメント

タイトルとURLをコピーしました