microCMS

Getting Started

こちらのドキュメントでは、microCMSをPHPアプリケーションから利用するための最短手順を示します。
初めてPHPアプリケーションからmicroCMSをご利用される場合にはまずはこちらの手順をお試しください。

事前に確認が必要なこと

  • microCMSのアカウント登録やサービス作成、API作成の仕方を理解している必要があります。操作マニュアルなどをご確認ください。
  • PHPとComposerが必要になります。ご自身の開発環境にインストールしてください。


はじめに
https://document.microcms.io/manual/getting-started
GitHub - microcmsio/microcms-php-sdk: microCMS PHP SDK.
https://github.com/microcmsio/microcms-php-sdk

microCMSのセットアップ

まずはmicroCMSで非常に単純なAPIを作成します。

  • オブジェクト形式
  • テキストフィールド1つ


設定例を以下に示していきます。APIの作成の詳細手順についてはAPIの作成もご参照ください。

APIの作成
https://document.microcms.io/manual/create-api

APIの作成画面で適当なAPI名とエンドポイントを入力します。



次にオブジェクト形式を選択します。



最後にフィールドを設定します。今回はテキストフィールドを一つのみ設定します。



上記設定でAPIを作成すると非常にシンプルな入稿画面ができあがるため値を入稿して公開します。



以下のようなcurlコマンドでJSONを取得できることも確認しておきましょう。(ターミナル等を開かなくても、上記画面内の「APIプレビュー」で即座に確認可能です)

curl "https://YOUR_SERVICE.microcms.io/api/v1/YOUR_ENDPOINT" -H "X-MICROCMS-API-KEY: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

PHPでデータを取得する


まずは composer.json を作成し、microcms-php-sdk をインストールしましょう。

$ composer init
$ composer require microcmsio/microcms-php-sdk


そして src/Main.php を作成してデータを取得するコードを書きます。YOURDOMAINYOURAPI_KEY はご自身が設定したものを設定してください。

<?php

require_once('vendor/autoload.php');

$client = new \Microcms\Client(
  "YOUR_DOMAIN",  // YOUR_DOMAIN は XXXX.microcms.io の XXXX 部分
  "YOUR_API_KEY"  // API Key
);

echo $client->get("hello")->text;


ローカルの src/Main.php を実行してみましょう。microCMS に入稿した内容を取得できます。

$ php ./src/Main.php
Hello, microCMS!