## 環境

- macOS: 11.1

## インストール

[shivammathur/homebrew-php](https://github.com/shivammathur/homebrew-php)を使用してバージョンアップします。（スターをつけておきましょう）※Homebrewのインストールなどは省きます。

```bash
brew tap shivammathur/php
brew install shivammathur/php/php@5.6
brew link --overwrite --force php@5.6
echo 'export PATH="/usr/local/opt/php@5.6/bin:$PATH"' >> ~/.bash_profile
php -v
```

以上でバージョンが`5.6.4`に切り替わります。

## もしエラーが発生した場合

[Remove PHP packages](https://github.com/shivammathur/homebrew-php/wiki/Cleanup)を確認してみてください。他のPHPパッケージがある場合、リンクさせるときにエラーが発生するかもしれません。PHPパッケージが複数ある場合は、使用しないPHPを`untap`して登録解除します。

```bash
Error: Formulae found in multiple taps: 
       * shivammathur/php/php@7.0
       * exolnet/deprecated/php@7.0
```

```bash
brew untap exolnet/deprecated
Untapping exolnet/deprecated...
Untapped 3 formulae (127 files, 213.9KB).
```

## 最後に

macOSに直接PHPを入れるのではなく、Dockerを使うのもありです。

macOS11でPHPバージョン5.6.4を使用する方法

環境

macOS: 11.1

インストール
shivammathur/homebrew-phpを使用してバージョンアップします。（スターをつけておきましょう）※Homebrewのインストールなどは省きます。
brew tap shiva…

## dateでよく使う値

```php
$today = date('Y-m-d'); // 今日の日付を取得する
$fromDate = date("Y-m-01"); // 月初の取得
$toDate = date("Y-m-t"); // 月末の取得
```

## Y-m-01からY-m-tのレコードを取得する

```php
$any = SomeTable::where('user_id', $userId)
    ->whereDate('from_date', '>=', $fromDate)
    ->whereDate('to_date', '<=', $toDate)
    ->get();
```

レコード数の取得

```php
count();
```

## 条件式

```php
$fromDate <= $date && $date <= $toDate
```

## whereNull whereNotNull

```php
$query->whereNull('判定対象カラム名');
$query->whereNotNull('判定対象カラム名');
```

## exists()

カラムの有無を確認する

```php
where(...)->exists()
```

Laravel

Laravel(PHP)で月初や月末でレコードの操作をする

## 環境

- Laravel

## 型の確認

型の確認

```php
Log::info(gettype($value));
=> array
```

確認

```bash
tail -f storage/logs/laravel.log 
```

オブジェクトや配列のLog出力
（Laravelのバージョンによっては普通に`Log::info();`で確認できる）

```php
Log::debug(print_r($user, true));
```

## Modelオブジェクトの確認

`get()`を使用し、Modelオブジェクトを使用する。

```php
$users = User::where('some_id', $some_id)->get();
Log::info($users);
foreach($users as $user) {
  Log::info($user);
}
```

## json_encode()

オブジェクト型の場合は、json_encode()を使用する。

```php
Log::info(json_encode($obj));
```

## array_push()

array をスタックとして処理し、渡された変数を array の最後に加える。

```php
$stack = array("荀彧", "荀攸");
array_push($stack, "郭嘉", "程イク");
print_r($stack);

Array
(
    [0] => 荀彧
    [1] => 荀攸
    [2] => 郭嘉
    [3] => 程イク
)
```

## in_array()

配列に値があるかチェックする。true/falseが返ってくる。

```php
$ary = ['曹操', '劉備', '孫権'];
print_r(in_array('劉備', $ary));
// 1
```

## 命名規則

- 変数名: スネークケース
- メソッド名: ロワーキャメル

## 参考

- [配列 関数](https://www.php.net/manual/ja/ref.array.php)
- [PHP Playground](https://www.tehplayground.com/)

Laravel(PHP)で配列操作とログの確認

## 意図

顧客のクレジットカード情報を更新する機能を作りたい。

- クレジットカードの有効期限切れ
- 謝って入力したケース

また、バックエンドはLaravelだが、 サーバレス(node.js)で構築してみたいのでエッセンス的なところを身に付けておきたい。

## 環境

- Laravel: 6.x
- Vue.js
- [Laravel Cashier (Stripe)](https://laravel.com/docs/8.x/billing)

## カードのテスト

テストできるカードは、[Stripe テスト方法](https://stripe.com/docs/testing)に記載されています。めちゃめちゃ親切なドキュメントですね。感動しました。

- VISA: `4242424242424242`
- Master Card: `5555555555554444`

を使いまわそうかなと。
\
エラーのテストや不正請求のテストも実施することができるので、便利です。

## お支払い方法(カード情報)の変更

詳細は、[Updating The Default Payment Method](https://laravel.com/docs/8.x/billing#updating-the-default-payment-method)に書いてあります。

## Lereval側(StripeController)

※`user()`はLaravelのAPIトークンを見て、Userを取得しています。

```php
// 支払いの意図を作成し、支払いを捕捉できるようにします
public function getSetupIntent( Request $request )
{
    return $request->user()->createSetupIntent();
}
```

```php
// 支払い方法の更新
public function updatePaymentMethod(Request $request) {
    $paymentMethod = $request->input('paymentMethod');
    $request->user()->updateDefaultPaymentMethod($paymentMethod); // ココで更新
    return $this->status(); // ステータスを返しています
}
```

## Vue.js側

```js
export default {
  data () {
    return {
      card: null,
      stripe: [],
      stripeAPIToken: YOUR_STRIPE_PUBLIC_KEY, // StripeのPublic Keyを入れる
      intentToken: ''
    }
  },

  mounted () {
    // eslint-disable-next-line no-undef
    this.stripe = Stripe(this.stripeAPIToken)
    const elements = this.stripe.elements()
    this.card = elements.create('card', { options }) // 任意のオプション
    this.card.mount('#card-element')
    this.loadIntent() // ここでgetSetupIntentを呼び出し
  },

  methods: {
    async submit () {
      // 決済情報の登録
      await this.stripe.confirmCardSetup(
        this.intentToken.client_secret, {
          payment_method: {
            card: this.card,
            billing_details: {}
          }
        }
      ).then(result => {
          this.updatePaymentMethod(result.setupIntent.payment_method)
          this.card.clear()
        }
      })
    },

    loadIntent () {
      this.axios.get('/get-setup-intent')
        .then(res => {
          this.intentToken = res.data
        })
    },

    /**
     * カード情報の更新
     * @param {object} paymentMethod 支払い情報
     * @return {void}
     */
    async updatePaymentMethod (paymentMethod) {
      const data = {
        paymentMethod: paymentMethod
      }
      await this.axios.post('/update-payment-method', data)
    }
  }
}
```

※`mounted`で`getSetupIntent`を呼び出しているので、処理を実行したあとは、コンポーネントを破棄してあげる。
\
また、apiのエンドポイントは、スパイナルケース(ケバブケース)が良いとのこと。メソッド名もDBの更新であれば、 changeよりも**update**を使用したい。

- 変更結果が永続化されるならupdate
- 変更結果が一時的なものならchange

## お支払い方法(カード情報)の作成

先ほどは更新だけでしたが、お支払い方法(カード情報)のみをユーザーに登録してもらいたいケースもあると思います。カード情報の登録は、顧客を作る必要があります。
`stripe_id`を確認し、ある場合は支払い方法の更新。ない場合は、顧客を作成した後に支払い方法を更新します。(stripe_idは、Userテーブルのカラムです。)

```php
// お支払い情報(カード情報)の作成/更新
public function savePaymentMethod(Request $request) {
    $user = $request->user();
    $paymentMethod = $request->input('paymentMethod');
    if ($user->stripe_id) {
        $user->updateDefaultPaymentMethod($paymentMethod);
    } else {
        // カード情報作成の場合、顧客を作る
        $user->email = decrypt($user->email);
        $user->createAsStripeCustomer();
        $user->updateDefaultPaymentMethod($paymentMethod);
    }
    return $this->status(); // 独自で作った
}
```

また、サブスクリプションの作成の際に既に支払い情報がある場合は、`add()`を使用します。

```php
$user->newSubscription('default', $planId)->add();
```

## お支払い方法(カード情報)の削除

お支払い情報の削除は、[Deleting Payment Methods](https://laravel.com/docs/8.x/billing#deleting-payment-methods)に書いてあります。

## 資料

- [Laravel Cashier (Stripe)](https://laravel.com/docs/8.x/billing)

Stripe

Stripeで支払い方法(カード情報)の変更 with Laravel

## 意図

- Freeプラン(無料)
- Basicプラン(有料)
- Standardプラン(有料)

があった場合、それらを作成/変更したい。また、Freeプランは、アカウントを作成した段階の状態とする。
\
サブスクリプションを実装する場合、顧客のデータが必要になる。

- メールアドレス
- StripeID
- paymentMethod

が顧客データに最低限必要なデータになる。また、請求先住所、支払い先住所は任意で紐づけることができる。

Stripeの全体的な支払い機能は、[Stripe 支払い](https://stripe.com/docs/payments)
顧客関する情報は、[Stripe 顧客](https://stripe.com/docs/billing/customer)
サブスク作成の概要は、[Subscriptions with Checkout and the customer portal](https://stripe.com/docs/billing/subscriptions/checkout)

## 作成する機能

- 領収書発行
- 次回請求月/キャンセル日の確認
- カード情報の作成/変更
- カード情報の削除(unsubscribedの場合のみ)
- カード番号(下四桁)とカードブランドの確認
- サブスクリプションの作成/変更
- サブスクリプションのキャンセル/次回請求月までサービスの利用
- 決済時にメールアドレスで連絡
- 引き落とし出来ない場合にメールアドレスで連絡

※サブスクリプションのプラン(商品)は直接Stripeから取得し、表示する

## 基本的な機能

- サブスクリプションの作成 -> 顧客の作成/`購読中(subscribed)`にステータスを変更
- サブスクリプションの解約 -> `キャンセル済(cancelled)`に変更
- サブスクリプションの解約の取り消し -> `購読中(subscribed)`にステータスを変更
- サブスクリプションのプランを変更
- 顧客のカード情報の更新 -> 顧客のpaymentMethodの変更
- 顧客のステータスの確認

おそらく、顧客のステータスとプランを確認し、ユーザーにサービスの利用権限を与えるように実装すると思う。また、Stripe Webhookで決済が作成したかなども実行する必要がありそう。([Webhook でイベント通知を受信する](https://stripe.com/docs/webhooks))

## Vue.js側のTIPS

`Subscription.js`というStoreを作り、細かい粒度でデータを分けて`computed`を使いやすくする。また、[Vuex](https://vuex.vuejs.org/ja/)の設計に乗っ取り、「ActionsでAPIを呼び出し、MutationsでStateの変更、gettersをcomputedで取得し、描画する」ことを意識する。グローバルに使用するデータに関するものはActionsに記載し、Mutationsまでつなげる。

### メリット

- Store: `User.js`の肥大化を避ける。([モジュール分割](https://vuex.vuejs.org/ja/guide/modules.html))
- ObjectのSetでcomputedがうまく動いてくれない問題を避ける。

```js
const state = {
  status: null,
  planId: null,
  planName: null,
  cardBrand: null,
  cardLastFour: null,
  endDate: null
}

const getters = {
  status: (state) => {
    return state.status
  },
  planId: (state) => {
    return state.planId
  },
  planName: (state) => {
    return state.planName
  },
  cardBrand: (state) => {
    return state.cardBrand
  },
  cardLastFour: (state) => {
    return state.cardLastFour
  },
  endDate: (state) => {
    return state.endDate
  }
}

const mutations = {
  SET_STATUS (state, status) {
    state.status = status
  },
  SET_PLAN_ID (state, planId) {
    state.planId = planId
  },
  SET_PLAN_NAME (state, planName) {
    state.planName = planName
  },
  SET_CARD_BRAND (state, cardBrand) {
    state.cardBrand = cardBrand
  },
  SET_CARD_LAST_FOUR (state, cardLastFour) {
    state.cardLastFour = cardLastFour
  },
  SET_END_DATE (state, endDate) {
    state.endDate = endDate
  }
}
```

+Actionsに、プロパティを確認し、まとめてMutationsするActionsを作成しておく。

## 環境

- Laravel: 6.x
- Vue.js
- [Laravel Cashier (Stripe)](https://laravel.com/docs/8.x/billing)

## 資料

- [Laravel Cashier (Stripe)](https://laravel.com/docs/8.x/billing)
- [Stripe 支払い](https://stripe.com/docs/payments)
- [Subscriptions with Checkout and the customer portal](https://stripe.com/docs/billing/subscriptions/checkout)
- [Webhook でイベント通知を受信する](https://stripe.com/docs/webhooks)

Stripeでプラン(サブスクリプション)の変更 with Laravel

Agora Analytics(Beta)をバシバシ叩いて調査していく。

## Agora RESTfulの準備

ブラウザ画面の右上のログインユーザーからRESTful APIの設定をクリックする。

![Agora RESTful](//images.ctfassets.net/0jyj5pjwic68/5UK2YQZCETSWDhRiH3CDAB/f9134569f592821df1e2d50620f1c0a5/Agora_RESTful.png)

Agora RESTful APIには、いくつかの特徴がある。
- RESTfulAPIはHTTPSのみをサポートします。
- HTTPリクエストを送信する前に、Agoraから提供されたカスタマーIDとカスタマーシークレットを使用してBase64でエンコードされたクレデンシャルを生成し、そのクレデンシャルをAuthorizationリクエストヘッダーのパラメーターに渡す必要があります。

AgoraのKeyとSecretを生成し、 txtをダウンロードしておく。（紛失しないように注意！）
ここで作成する`Key`と`Secret`は、`AppId`,`Certificate`とは別物です。RESTful APIを使用するため専用のようです。

![Agora RESTful secret](//images.ctfassets.net/0jyj5pjwic68/FQsWLIx9EN6s6I9DOEINR/6141db39aa1beae1628b5f45b6c37478/Agora_RESTful_secret.png)

## Basic HTTP認証を使い、API Call

ここでの例は、Laravelを使用しているのでPHPを使用しています。基本的に、`Java`,`Go`,`PHP`,`node.js`,`C#`,`Python`のサンプルコードが記載されているようです。

まず、`.env`に設定する。

```bash
AGORA_APP_ID=
AGORA_CERTIFICATE=
AGORA_CUSTMOR_KRY=
AGORA_CUSTMOR_SECRET=
# 後で追記した
AGORA_PROJECT_ID=
AGORA_PROJECT_NAME=
```

Agora RESTful APIを呼び出すメソッド(LaravelのController)。
ここには書いていないが動的キーを生成したりしている。(`try ~ catch`は、とりあえず書いている。)

```php
public function getProjects(Request $request)
{
  try {
    $this->execAgoraRestful();
  } catch (\Exception $e) {
    return ['error' => $e->getMessage()];
  }
}
```

Agora RESTful APIを実行するメソッド

```php
/**
 * Agora RESTful APIを試す
 */
public function getProjects()
{
  try {
    // HTTP basic authentication example in PHP using the RTC Server RESTful API
    // Customer ID
    $customerKey = env('AGORA_CUSTMOR_KRY');
    // Customer secret
    $customerSecret = env('AGORA_CUSTMOR_SECRET');
    // Concatenate customer key and customer secret
    $credentials = $customerKey . ":" . $customerSecret;

    // Encode with base64
    $base64Credentials = base64_encode($credentials);
    // Create authorization header
    $arr_header = "Authorization: Basic " . $base64Credentials;

    $curl = curl_init();
    // Send HTTP request
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://api.agora.io/dev/v1/projects',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => '',
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => 'GET',

      CURLOPT_HTTPHEADER => array(
        $arr_header,
        'Content-Type: application/json'
      ),
    ));

    $response = curl_exec($curl);

    if($response === false) {
        echo "Error in cURL : " . curl_error($curl);
    }

    curl_close($curl);

    Log::info((string) $response);
    // echo $response;
  } catch (\Exception $e) {
      return ['error' => $e->getMessage()];
  }
}
```

ここで使用されたAPIは、`dev/v1/projects`です。そのほかのAPIは、[Server RESTful API](https://docs.agora.io/en/rtc/restfulapi/)に記載されています。「Try it out」からAPIを試してみることもできます。
```php
$arr_header = "Authorization: Basic " . $base64Credentials;
```
というパラメータをつけてHTTPリクエストを送ることで認証しています。
先ほど実行したAPIから`PROJECT_ID`が返ってきます。これは`APP_ID`とは異なるようです。
\
プロジェクトを指定して取得するAPIは、
`https://api.agora.io/dev/v1/project?id={PROJECT_ID}&name={PROJECT_NAME}`ですが、ここには`APP_ID`ではなく、`PROJECT_ID`を渡します。
\
トークン認証もありますが、使用例がよくわかっていないので、様子見です。(トークン認証は、動的キーとUIDが必要になります。)

## 例) GET/dev/v3/usage

一部抜粋

```php
$projectID = env('AGORA_PROJECT_ID');

// 現在の月初と月末を取得
$from_date = date("Y-m-01");
$to_date = date("Y-m-t");

// Send HTTP request
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.agora.io/dev/v3/usage?project_id=$projectID&from_date=$from_date&to_date=$to_date&business=default",
));
```

## Agora Analytics RESTful API (Beta)

[Agora Analytics RESTful API (Beta)](https://docs.agora.io/en/Agora%20Platform/aa_api)を試してみます。ここまではこの為の準備です。
目的としては、UID毎の通話時間を割り出したいです。

ユーザーの通話時間の取得方法については、[How do I get the user's call duration?](https://docs.agora.io/en/Video/faq/business_billing)こちらに書いてありました。

## ユーザー毎の通話時間を割り出す

ユーザーの通話時間の取得方法については2つあるようです。

- Agora RTCSDKを使用する
- Agora Analyticsを使用する

Agora RTCSDKはブラウザで使用するのでネットワーク切れなど不安があります。然るにAgora Analyticsの[Call Search](https://docs.agora.io/en/Agora%20Analytics/aa_api?platform=RESTful#a-namesearchacall-search)を使用して、取得する方法で行きます。
また、Call Search APIには、過去3日間の制限などがあるので確認してください。
\
しかし、Call Search APIのレスポンスに「You cannot consume this service as you are not invited, please contact Agora support」を表示されるので、Agoraのサポートに連絡中です。
\
もしかしたら、Agora RTCSDKで通話中に計測するのが良いかもしれません。なので少し実装してみます。

## Agora RTCSDK

[Report Call Statistics](https://docs.agora.io/en/Video/in-call_quality_web_ng?platform=Web#get-the-statistics-of-the-call)に詳細が記載されています。

`Vue.js`ですが、このような形で取得できます。DBに加算していけば良いかと思います。

```js
async leave () {
  const clientStats = this.rtc.client.getRTCStats()
  console.log('clientStats', clientStats)

  // Leave the channel.
  await this.rtc.client.leave()
},
```

## 資料

- [Agora RESTful API](https://docs.agora.io/en/agora%20platform/dashboard_restful_communication)
- [Agora Server RESTful API](https://docs.agora.io/en/rtc/restfulapi/)
- [How can I pass the basic HTTP authentication or token authentication?](https://docs.agora.io/en/Agora%20Platform/faq/restful_authentication)
- [Agora Analytics RESTful API (Beta)](https://docs.agora.io/en/Agora%20Platform/aa_api)
- [How do I get the user's call duration?](https://docs.agora.io/en/Video/faq/business_billing)

macOS11でPHPバージョン5.6.4を使用する方法

環境

インストール

もしエラーが発生した場合

最後に

関連記事