ページ 7

C#でWOL（Wake-on-LAN）

福岡の香月です。

コロナ対応で世の中はリモートワークが進んでいるようです。中程度スペックの中古PCもたくさん売れているようで、在庫が少なくなっているようですね。

自宅作業する場合、会社のPCにリモートデスクトップでつないで作業することも多いと思いますが、気付いたらPCがシャットダウンしていることがあります。間違って電源切ったとか、夜中にWindows Updateが動いたとか。

そんな時はWOL（Wake-on-LAN）ですが、私はこれについて知識が無かったので調べがてらC#プログラムのWOLツールを作ってみました。プラットフォームは.Net Core 3.1です。
以下全文です。どん！

[crayon-678bf1c411bd3428833919  ]
using System;
using System.IO;
using System.Net.Sockets;
using System.Reflection;
using Microsoft.Extensions.Configuration;

namespace WakeOnLAN
{
    class Program
    {
        static void Main(string[] args)
        {
            string name = Assembly.GetEntryAssembly().GetName().Name;
            ConfigurationBuilder builder = new ConfigurationBuilder();
            builder.SetBasePath(Directory.GetCurrentDirectory());
            builder.AddIniFile(name + ".ini");
            IConfiguration config = builder.Build();

            string host = config["host"];
            string sport = config["port"];
            string macAddr = config["macAddr"];

            if (string.IsNullOrEmpty(host))
            {
                Console.WriteLine("設定ファイルに host が設定されていません。");
                return;
            }
            if (string.IsNullOrEmpty(sport))
            {
                Console.WriteLine("設定ファイルに port が設定されていません。");
                return;
            }
            if (string.IsNullOrEmpty(macAddr))
            {
                Console.WriteLine("設定ファイルに macAddr が設定されていません。");
                return;
            }

            int port = 0;
            if (!int.TryParse(sport, out port))
            {
                Console.WriteLine("ポート番号が不正です。");
                return;
            }

            // macアドレス文字列をバイト配列に
            string[] bsary = macAddr.Split('-');
            if (bsary.Length != 6)
            {
                Console.WriteLine("macアドレスが正しくありません。\nipconfig /all で確認してください。\n例）1A-2B-3C-D4-EE-99");
                return;
            }
            byte[] bmac = new byte[6];
            for (int i = 0; i &lt; 6; ++i)
                bmac[i] = Convert.ToByte(bsary[i], 16);

            byte[] packet = new byte[6 + 6 * 16];
            Array.Copy(new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }, 0, packet, 0, 6);
            for (int i=1; i&lt;=16; ++i)
                Array.Copy(bmac, 0, packet, i * bmac.Length, bmac.Length);

            try
            {
                UdpClient udp = new UdpClient();
                udp.Send(packet, packet.Length, host, port);
            }
            catch (Exception e)
            {
                Console.WriteLine("マジックパケットの送信時に例外が発生しました。\n" + e.ToString());
            }
        }
    }
}

[crayon-678bf1c411bd3428833919 ]

using System;

using System.IO;

using System.Net.Sockets;

using System.Reflection;

using Microsoft.Extensions.Configuration;

namespace WakeOnLAN

{

class Program

{

static void Main(string[] args)

{

string name = Assembly.GetEntryAssembly().GetName().Name;

ConfigurationBuilder builder = new ConfigurationBuilder();

builder.SetBasePath(Directory.GetCurrentDirectory());

builder.AddIniFile(name + ".ini");

IConfiguration config = builder.Build();

string host = config["host"];

string sport = config["port"];

string macAddr = config["macAddr"];

if (string.IsNullOrEmpty(host))

{

Console.WriteLine("設定ファイルに host が設定されていません。");

return;

}

if (string.IsNullOrEmpty(sport))

{

Console.WriteLine("設定ファイルに port が設定されていません。");

return;

}

if (string.IsNullOrEmpty(macAddr))

{

Console.WriteLine("設定ファイルに macAddr が設定されていません。");

return;

}

int port = 0;

if (!int.TryParse(sport, out port))

{

Console.WriteLine("ポート番号が不正です。");

return;

}

// macアドレス文字列をバイト配列に

string[] bsary = macAddr.Split('-');

if (bsary.Length != 6)

{

Console.WriteLine("macアドレスが正しくありません。\nipconfig /all で確認してください。\n例）1A-2B-3C-D4-EE-99");

return;

}

byte[] bmac = new byte[6];

for (int i = 0; i < 6; ++i)

bmac[i] = Convert.ToByte(bsary[i], 16);

byte[] packet = new byte[6 + 6 * 16];

Array.Copy(new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }, 0, packet, 0, 6);

for (int i=1; i<=16; ++i)

Array.Copy(bmac, 0, packet, i * bmac.Length, bmac.Length);

try

{

UdpClient udp = new UdpClient();

udp.Send(packet, packet.Length, host, port);

}

catch (Exception e)

{

Console.WriteLine("マジックパケットの送信時に例外が発生しました。\n" + e.ToString());

}

[/crayon]

特徴

マジックパケットを飛ばします。マジックパケットとは…
- UDPで送信するパケット
- 先頭6バイトに{ 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }
- 続けて対象PCのmacアドレスを16回
- 合わせて102バイトのパケットとなる。
exeと同じ名前のiniファイルを設定ファイルとして読み込む
設定ファイルにて以下を設定
- host=対象PCのIPアドレス
- post=UDPポート（ルータが許可したポートであれば何でもOK）
- macアドレス=対象PCのmacアドレス
エラーが発生した場合はコンソール上にエラーを表示

プログラムは案外簡単でびっくりしました。
それよりもWOLが使える環境の設定が大変そうですね。BIOS、ネットワークカード、Windowsの設定など、情報はぐぐればいろいろ出てきますので一度お試しあれ。

Swagger-PHPでOA\PathItem()エラー

福岡拠点の野田です。
OpenAPI(Swagger)の仕様書を使っていますか？

PHPでは、アノテーションでOpenAPIを定義できるSwagger-PHPというものがあります。使うためには以下を実行します。

[crayon-678bf1c411fbc518407733  ]composer require --dev zircote/swagger-php

1	[crayon-678bf1c411fbc518407733 ]composer require --dev zircote/swagger-php

[/crayon]

対象のコントローラーを指定するとアノテーションで記載したコメントがAPI仕様書になるという素晴らしいライブラリです。swagger.ymlの書き出し方は、以下。

[crayon-678bf1c411fc0512757019  ]vendor/zircote/swagger-php/bin/openapi app/Http/Controllers/Api/*Controller.php -o swagger.yml

1	[crayon-678bf1c411fc0512757019 ]vendor/zircote/swagger-php/bin/openapi app/Http/Controllers/Api/*Controller.php -o swagger.yml

[/crayon]

ここで少しはまりどころがあります。
OA\Infoを定義したクラスには必ずOA\GetやOA\PutといったAPIをセットで定義しなければなりません。それをしないと以下のエラーで怒られます。

[crayon-678bf1c411fc3557925470  ]Required @OA\PathItem() not found

1	[crayon-678bf1c411fc3557925470 ]Required @OA\PathItem() not found

[/crayon]

ちょー分かりにくいエラーなので、私もはまりました。そんなときは汎用エラーレスポンスでも定義してしのぎましょう。

[crayon-678bf1c411fc7480187926  ]    /**
     * @OA\Put(
     *     path="/api/*",
     *     tags={"ErrorCommon"},
     *     description="APIエラー共通",
     *     @OA\Response(
     *          response="default",
     *          description="APIエラー時の返却データ",
     *          @OA\JsonContent(
     *              @OA\Property(property="error", type="integer", description="エラー値(0:正常/1:エラー)"),
     *              @OA\Property(property="errorId", type="string", description="エラーID"),
     *              @OA\Property(property="code", type="string", description="エラーコード"),
     *              @OA\Property(property="message", type="string", description="エラーメッセージ"),
     *          )
     *     )
     * ),
     */
    private function error() {
        throw new UnsupportedOperationException();
    }

[crayon-678bf1c411fc7480187926 ] /**

* @OA\Put(

* path="/api/*",

* tags={"ErrorCommon"},

* description="APIエラー共通",

* @OA\Response(

* response="default",

* description="APIエラー時の返却データ",

* @OA\JsonContent(

* @OA\Property(property="error", type="integer", description="エラー値(0:正常/1:エラー)"),

* @OA\Property(property="errorId", type="string", description="エラーID"),

* @OA\Property(property="code", type="string", description="エラーコード"),

* @OA\Property(property="message", type="string", description="エラーメッセージ"),

* )

* ),

private function error() {

throw new UnsupportedOperationException();

}

[/crayon]

これはライブラリ側でなんとかしてほしかったところではありますが、めげずにswaggerを使っていきましょう。

それでは、また！

nuxt.js環境を構築する

福岡拠点の野田です。

サーバーサイドでレンダリングするSSR(Server Side Rendering)を次の案件で使うことにしました。API側は慣れ親しんだLaravel。

最初に悩むのが環境構築。
どうしようか、というところで参考にしたのが、次の記事。

LaravelとNuxt.jsを同一レポジトリで管理するときの構成https://www.wantedly.com/companies/roxx/post_articles/84615

client フォルダ以下に環境を作る例ですが、とても参考になりました。以下おっかけになりますが手順になります。

[crayon-678bf1c412222591078419  ]install -d client/pages/.gitkeep
install -d client/assets/.gitkeep
install -d client/components/.gitkeep
install -d client/layouts/.gitkeep
install -d client/middleware/.gitkeep
install -d client/plugins/.gitkeep
install -d client/static/.gitkeep
install -d client/store/.gitkeep

[crayon-678bf1c412222591078419 ]install -d client/pages/.gitkeep

install -d client/assets/.gitkeep

install -d client/components/.gitkeep

install -d client/layouts/.gitkeep

install -d client/middleware/.gitkeep

install -d client/plugins/.gitkeep

install -d client/static/.gitkeep

install -d client/store/.gitkeep

[/crayon]

nuxtは起動フォルダ配下に.nuxtという一時ファイルを作成します。このため設定ファイルをclient以下に配置して、このフォルダを起動フォルダとします。

設定ファイル (nuxt.config.js)

[crayon-678bf1c412226755170825  ]module.exports = {
    srcDir: '../client/',

    server: {
        port: 5000, // デフォルト: 3000
        host: 'localhost', // デフォルト: localhost,
        timing: false
    },
    css: [
        'bootstrap/dist/css/bootstrap.css',
        'bootstrap-vue/dist/bootstrap-vue.css',
    ],
    plugins: [
        '@/plugins/bootstrap',
    ]
}

[crayon-678bf1c412226755170825 ]module.exports = {

srcDir: '../client/',

server: {

port: 5000, // デフォルト: 3000

host: 'localhost', // デフォルト: localhost,

timing: false

css: [

'bootstrap/dist/css/bootstrap.css',

'bootstrap-vue/dist/bootstrap-vue.css',

plugins: [

'@/plugins/bootstrap',

]

}

[/crayon]

起動シェル(再起動シェル)は以下のような感じで作ります。

[crayon-678bf1c41222a962528745  ]#!/bin/bash

export nuxt_count=`grep -a "" /proc/*/cmdline | xargs -P1 -r -0 | grep -s nuxt.config.js | grep -v -E '(grep|\.sh)' | wc -l`
while [ $nuxt_count -gt 0 ]
do
    ps aux |grep nuxt.config.js | grep -v -E '(grep|\.sh)' | gawk '{print $2}' | xargs -r kill -9
    sleep 1
    export nuxt_count=`grep -a "" /proc/*/cmdline | xargs -P1 -r -0 | grep -s nuxt.config.js | grep -v -E '(grep|\.sh)' | wc -l`
done

echo "" | ../node_modules/.bin/nuxt -c ./nuxt.config.js &

[crayon-678bf1c41222a962528745 ]#!/bin/bash

export nuxt_count=`grep -a "" /proc/*/cmdline | xargs -P1 -r -0 | grep -s nuxt.config.js | grep -v -E '(grep|\.sh)' | wc -l`

while [ $nuxt_count -gt 0 ]

ps aux |grep nuxt.config.js | grep -v -E '(grep|\.sh)' | gawk '{print $2}' | xargs -r kill -9

sleep 1

export nuxt_count=`grep -a "" /proc/*/cmdline | xargs -P1 -r -0 | grep -s nuxt.config.js | grep -v -E '(grep|\.sh)' | wc -l`

done

echo "" | ../node_modules/.bin/nuxt -c ./nuxt.config.js &

[/crayon]

ちなみにecho “” | はjenkinsから呼び出したとき、標準入力を要求されたので、それ対策で入れています。

このシェルを実行することでnuxt.jsサーバーが起動します。

nuxtは素のvueでやるよりも以下の点で優れていると思います。

自動でルーティングしてくれる。
レイアウト機構を持っている。
API連携の仕組みも実装しやすい形で持っている。

VueやReactやAngularは、マイクロサービスをつなげる糊の役割をしているフレームワークだと思います。これからもっと深く使っていきたいと思います。

JQコマンドをおぼえた

福岡拠点の野田です。久しぶりの投稿です。

ある案件でAWSを扱っており、ELBからインスタンスが切り離されたか確認してほしいと連絡がありました。生憎、AWS Consoleへの接続アカウントをもらっていない状態で調べられない…と思ったのですが、aws-cliがインストールされてあるサーバーがあることに気づき、そちらで確認してみました。

ELBの一覧を表示するコマンドは以下のようなものになります。

[crayon-678bf1c412414054511073  ] aws --output json --region ap-northeast-1 elb describe-load-balancers

1	[crayon-678bf1c412414054511073 ] aws --output json --region ap-northeast-1 elb describe-load-balancers

[/crayon]

けれども、awsのコマンドで出てくる内容はjsonで縦に長い！必要な情報だけに整理したいときに役立つのがjq(恐らくjson queryの略)コマンドになります。jsonの中からDNSNameと紐づくインスタンスを見たい場合は、以下のようなクエリをjqに投げます。

[crayon-678bf1c412418677353247  ] aws --output json --region ap-northeast-1 elb describe-load-balancers | jq -r '.LoadBalancerDescriptions[] | {DNSName, Instances}'

1	[crayon-678bf1c412418677353247 ] aws --output json --region ap-northeast-1 elb describe-load-balancers \| jq -r '.LoadBalancerDescriptions[] \| {DNSName, Instances}'

[/crayon]

jqコマンドの基本は、配列のフィルターと生成。.から始まる要素がフィルターされる内容になります。{}や[]で配列を再構築します。詳しいやり方は以下をご参考ください。

https://dev.classmethod.jp/tool/jq-manual-japanese-translation-roughly/

すぐれものなのは、jsonからcsvを作れること。以下のような感じでフィルターと配列の再構築を利用すれば、@csvでcsvの作成も楽々です。

[crayon-678bf1c41241c998750041  ]aws --output json --region ap-northeast-1 elb describe-load-balancers | jq -r '.LoadBalancerDescriptions[] | [.DNSName, .Instances[].InstanceId] | @csv'

1	[crayon-678bf1c41241c998750041 ]aws --output json --region ap-northeast-1 elb describe-load-balancers \| jq -r '.LoadBalancerDescriptions[] \| [.DNSName, .Instances[].InstanceId] \| @csv'

[/crayon]

zabbixと連携させたりとか、レポート出力を簡易化できないかとか夢が広がりますよね？是非、jqを使ってより良いjsonライフを！

PHPUnit_その３(データプロバイダ)

福岡拠点の永嵜です。

前回に引き続きPHPUnitの機能を紹介します。

今回はデータプロバイダ機能を紹介します。
データプロバイダ機能とは、テストメソッドに任意の引数を渡せる機能です。
データプロバイダを使用すると同じテストメソッドで様々なテストができる利点があります。

データプロバイダ機能

例題を示しながら説明します。
前回使用したテストケースにデータプロバイダを追加します。

■テストケース

class AreaCalcTest extends TestCase
{

    /**
     * @dataProvider traiangleProvider
     */
    public function testGetTriangleArea($width,$height,$expected)
    {
        
        $actual = AreaCalc::getTriangleArea($width,$height);
        
        //$expected と　$actualが等しくない場合エラー
        $this->assertEquals($expected,$actual);
    }
    
    public function  traiangleProvider()
    {
        return [
            'ok pattern' => [4, 2, 4],
            'ng pattern' => [4, 2, 10],
        ];
        
    }

}

class AreaCalcTest extends TestCase

{

/**

* @dataProvider traiangleProvider

public function testGetTriangleArea($width,$height,$expected)

{

$actual = AreaCalc::getTriangleArea($width,$height);

//$expected と　$actualが等しくない場合エラー

$this->assertEquals($expected,$actual);

}

public function traiangleProvider()

{

return [

'ok pattern' => [4, 2, 4],

'ng pattern' => [4, 2, 10],

];

}

traiangleProviderメソッドがデータプロバイダになります。
[4, 2, 4]、 [4, 2, 10※1]がテストメソッドに渡す引数になります。
[横、縦、想定値]のデータをテストメソッドに渡します。
配列一つが1テスト用のデータになります。

※1 今回データプロバイダの説明のために想定値に誤った値を設定してテスト失敗を発生させています。

データプロバイダのデータにラベルを付けることができます。
(‘ok pattern’/’ng pattern’)
ラベルを付けることによってテスト失敗時にどのデータで失敗しているかを確認しやすくなります。
データプロバイダからデータを受け取るにはテストメソッドに@dataProviderアノテーションを付けます。

■実行

vendor\bin\phpunit test\
PHPUnit 7.5.6 by Sebastian Bergmann and contributors.

.F                                                                  2 / 2 (100%)

Time: 853 ms, Memory: 14.00 MB

There was 1 failure:

1) Tests\Unit\Test\AreaCalcTest::testGetTriangleArea with data set "ng pattern" (4, 2, 10)
Failed asserting that 4 matches expected 10.

/var/www/everegi/tests/Unit/Test/AreaCalcTest.php:20

FAILURES!
Tests: 2, Assertions: 2, Failures: 1.

vendor\bin\phpunit test\

PHPUnit 7.5.6 by Sebastian Bergmann and contributors.

.F 2 / 2 (100%)

Time: 853 ms, Memory: 14.00 MB

There was 1 failure:

1) Tests\Unit\Test\AreaCalcTest::testGetTriangleArea with data set "ng pattern" (4, 2, 10)

Failed asserting that 4 matches expected 10.

/var/www/everegi/tests/Unit/Test/AreaCalcTest.php:20

FAILURES!

Tests: 2, Assertions: 2, Failures: 1.

‘ng pattern’のデータでテスト失敗となりました。

また、実行時にfilterオプションを使用すると実行したいテストデータだけテストすることができます。

■データ指定(ok pattern)で実行

vendor\bin\phpunit test\  --filter '@ok pattern'
PHPUnit 7.5.6 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 711 ms, Memory: 14.00 MB

OK (1 test, 1 assertion)

vendor\bin\phpunit test\ --filter '@ok pattern'

PHPUnit 7.5.6 by Sebastian Bergmann and contributors.

. 1 / 1 (100%)

Time: 711 ms, Memory: 14.00 MB

OK (1 test, 1 assertion)

最後に

前回、今回、PHPUnitの概要を説明しましたが、PHPUnitには
コマンドオプション、アノテーション、アサーションなど他にも便利な機能があるので詳細を知りたい方は下記をチェックしてみてください。

PHPUnit マニュアル

https://phpunit.readthedocs.io/ja/latest/index.html

PHPUnit_その２(実行手順)

福岡拠点の永嵜です。

前回に引き続き、PHPUnitを紹介します。
今回はPHPUnitの実行手順を紹介します。実行環境は前回 Composer を使用してインストールした環境で行います。

PHPUnitの実行

PHPUnitでは理解するべき３つの要素があります。

①テスト対象クラス
ユニットテストを行うテスト対象のクラスです。

②テストケースクラス
テストケースは原則としてテスト対象クラスに対して1つ作成します。テストケースは、PHPUnit\Framework\TestCase※1 を継承して作成します。一般的にテストするクラス名の末尾に「Test」という文字列を付与したものをテストケース名とします（ファイル名はテストケースクラス名.php）。

- テストケースクラス名 ：「[テストするクラス名]Test」
- ファイル名 ：テストケースクラス名.php

※1:vendorフォルダー配下にあります。

③テストメソッド
テストケース内に記述するメソッドです。実際にテストをする単位となります。
テストメソッドの名称は「test」で始まる文字列にする必要があります。
※@testアノテーションを使用する場合は、「test」でなくてもよいです。

では実際にテストケースを作成し、実行してみましょう。

まず、開発用ディレクトリにテスト対象クラスを格納する src ディレクトリとテストケースクラスを格納する test ディレクトリを作成します。

■テスト対象作成

テスト対象となるクラスを用意します。

<?php

namespace Sample;

class AreaCalc
{
    /**
     * 三角形の面積を算出
     * @param int $width
     * @param int $height
     * @return double
     */
    public static function getTriangleArea($width,$height)
    {
        return $width*$height / 2;
    }
}

<?php

namespace Sample;

class AreaCalc

{

/**

* 三角形の面積を算出

* @param int $width

* @param int $height

* @return double

public static function getTriangleArea($width,$height)

{

return $width*$height / 2;

}

引き数で横、高さを受け取り三角形の面積を返すクラスです。

■テストケースとテストメソッド作成

テスト対象が完成したらテストケースとテストメソッドを作成します。
test ディレクトリに AreaCalcTest.php ファイルを作成し、次のように記入します。

<?php
require_once('vendor/autoload.php');

use PHPUnit\Framework\TestCase;
use Sample\AreaCalc;


class AreaCalcTest extends TestCase
{
    
    /**
     * @group getTriangleArea
     */
    public function testGetTriangleArea()
    {
        $width = 4;
        $height = 2;
        $expected= 4;  // 期待値 4×2 /2 = 4

        $actual = AreaCalc::getTriangleArea($width,$height);
        
        //$expected と　$actualが等しくない場合エラー
        $this->assertEquals($expected,$actual);
    }
    
}

<?php

require_once('vendor/autoload.php');

use PHPUnit\Framework\TestCase;

use Sample\AreaCalc;

class AreaCalcTest extends TestCase

{

/**

* @group getTriangleArea

public function testGetTriangleArea()

{

$width = 4;

$height = 2;

$expected= 4; // 期待値 4×2 /2 = 4

$actual = AreaCalc::getTriangleArea($width,$height);

//$expected と　$actualが等しくない場合エラー

$this->assertEquals($expected,$actual);

}

このテストケースでは、$width(横)と $height(高さ)で計算した面積が正しいかをテストしています。テストメソッドではアサーションと呼ばれる結果判定メソッドを使用します。今回の例ではassertEqualsがアサーションメソッドになります。
ちなみにassertEqualsは2 つの引数が等しくない場合エラーとするメソッドです。
$expectedに想定値、$actualに実測値を設定しassertEqualsで判定しています。

図1のように開発用ディレクトリ(Sample)内にテスト対象(AreaCalc)とテストケース(AreaCalcTest)を配置しています。

■実行

phpunit コマンドを実行してユニットテストを行います。
phpunitはPHPUnitをインストールしたディレクトリのvendor\binフォルダ配下にシンボリックリンクがあります。

全てのテストケースの実行、特定のテストケースだけ実行どちらもできます。
今回はテストケースが1つですが①の方法で実行します。

①テストケースを全て実行する場合
・vendor\bin\phpunit テストケース保存フォルダ
⇒例：vendor\bin\phpunit test\

②テストケースを指定して実行する場合
・vendor\bin\phpunit テストケース指定
⇒例：vendor\bin\phpunit test\AreaCalcTest

※上記方法以外にもコマンドオプションで制御する方法があります。詳しくは PHPUnitマニュアルをご確認ください。

コマンドプロンプトを開き次のように入力します。
test ディレクトリ内のファイルをテストケースとしてテストが実行されます。

vendor\bin\phpunit test\

1	vendor\bin\phpunit test\

■テスト結果

テストが実行されるとテスト結果ステータス(4行目)が表示されます。
AreaCalcは正しい結果を返す状態なので( $width = 4、 $height = 2を引数で与えると4が返ってくる)テスト成功.（ドット）となっています。

PS C:\xampp\htdocs\Sample> vendor\bin\phpunit test\
PHPUnit 8.0.4 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 3.24 seconds, Memory: 4.00 MB

OK (1 test, 1 assertion)

PS C:\xampp\htdocs\Sample> vendor\bin\phpunit test\

PHPUnit 8.0.4 by Sebastian Bergmann and contributors.

. 1 / 1 (100%)

Time: 3.24 seconds, Memory: 4.00 MB

OK (1 test, 1 assertion)

他のステータス表示は以下のようになります。

ステータス	意味
.（ドット）	テスト成功
F	テスト失敗
E	テストが危険としてマーク
S	テストをスキップした
I	テストが未実装

以上がPHPUnitによる一連のテスト手順となります。

次回は今回実行したサンプルプログラムに手を加え、
データプロバイダ機能について説明したいと思います。

PHPUnit_その１(インストール)

福岡拠点の永嵜です。

PHPUnitを使用する機会があったのでPHPUnitの使い方を紹介します。

本ブログでは下記の流れで説明していきます。
・PHPUnitの概要
・PHPUnit のインストール
・PHPUnitの実行

PHPUnitの概要

■PHPUnit
PHPで実装されたプログラムのユニットテスト(単体テスト)※1を自動化するためのテスティングフレームワークです。

※1:ユニットテスト
ユニットテストとはクラスや関数などプログラムを構成する小さな単位(ユニット)で個々の動作を確認するためのテストです。

PHPUnit のインストール

■PHPUnit のインストール
PHPUnitを使用するためにPHPUnitのインストールを行います。
インストールは下記方法があります。
・公式サイトから直接ダウンロードする。
・Composer を利用する

今回はComposerを利用した手順でインストールを行います。

①開発用ディレクトリに composer.json を設置し、次のように記入します。

{
    "require-dev": {
        "phpunit/phpunit": "*"
    }
}

{

"require-dev": {

"phpunit/phpunit": "*"

}

②コマンドプロンプトで下記コマンドを実施します。

composer update

1	composer update

③インストール結果を確認します。
・開発用ディレクトリにcomposer.lock ファイルと vendor ディレクトリが生成されます。
・下記コマンドを開発用ディレクトリにで実行しPHPUnitが実行できることを確認します。
実行ができたらインストールしたPHPUnitのバージョンが表示されます。

vendor\bin\phpunit --version

1	vendor\bin\phpunit --version

以上がPHPUnitのインストール手順となります。

次回はPHPUnitを実行する手順について説明したいと思います。

PHP7の新規機能その２

福岡拠点の永嵜です。

前回に引き続き、PHP7.0以降に追加された機能を紹介します。

１．define() を用いた配列定数の定義
define() で配列の定数を定義できるようになりました。

サンプルプログラム
echoでANIMALSの要素1を出力しています。

define('ANIMALS', [
    'dog',
    'cat',
    'bird'
]);

echo ANIMALS[1]; // "cat" と出力します

define('ANIMALS', [

'dog',

'cat',

'bird'

]);

echo ANIMALS[1]; // "cat" と出力します

２．use 宣言のグループ化
複数のクラスや関数そして定数を同じ namespace からインポートする際に、
単一の use 文にまとめられるようになりました。

サンプルプログラム

// 以前のバージョンのコード
use some\namespace\ClassA;
use some\namespace\ClassB;
use some\namespace\ClassC as C;

// PHP 7 以降のコード
use some\namespace\{ClassA, ClassB, ClassC as C};

// 以前のバージョンのコード

use some\namespace\ClassA;

use some\namespace\ClassB;

use some\namespace\ClassC as C;

// PHP 7 以降のコード

use some\namespace\{ClassA, ClassB, ClassC as C};

３．例外処理における複数の例外の catch
ひとつの catch ブロックで複数の例外を扱えるようになりました。
パイプ文字 (|) を使って指定します。
異なる例外を同じように処理したい場合に有用です。

サンプルプログラム

try {
    // 何かのコード
} catch (FirstException | SecondException $e) {
    // FirstException と SecondException をこのブロックで処理します
}

try {

// 何かのコード

} catch (FirstException | SecondException $e) {

// FirstException と SecondException をこのブロックで処理します

}

４．list() におけるキーのサポート
list() (あるいはその短縮版である [] 構文) の内部でキーを
指定できるようになりました。
list()及び[]で変数の中身を受け取る時もキーを指定した書き方が
出来るようになりました。

サンプルプログラム

$data = [
["id" => 1, "name" => 'Tom'],
["id" => 2, "name" => 'Fred'],
];

// list() 形式
foreach ($data as list("id" => $id, "name" => $name)) {
print "結果1 "."id: " .$id." name:".$name ."\n" ;
}

foreach ($data as list("name" => $name,"id" => $id )) {
print "結果2 "."id: " .$id." name:".$name ."\n" ; 
}

// [] 形式
foreach ($data as ["id" => $id, "name" => $name]) {
print "結果3 "."id: " .$id." name:".$name ."\n" ;
}

foreach ($data as ["name" => $name,"id" => $id ]) {
print "結果4 "."id: " .$id." name:".$name ."\n" ;
}

function getList(){
$test = [
["id" => 1,"name" => "田中"]
];
return $test[0];
}

list("name" => $name,"id" => $id) = getList();
print "結果5 "."id: " .$id." name:".$name ."\n" ;

$data = [

["id" => 1, "name" => 'Tom'],

["id" => 2, "name" => 'Fred'],

];

// list() 形式

foreach ($data as list("id" => $id, "name" => $name)) {

print "結果1 "."id: " .$id." name:".$name ."\n" ;

}

foreach ($data as list("name" => $name,"id" => $id )) {

print "結果2 "."id: " .$id." name:".$name ."\n" ;

}

// [] 形式

foreach ($data as ["id" => $id, "name" => $name]) {

print "結果3 "."id: " .$id." name:".$name ."\n" ;

}

foreach ($data as ["name" => $name,"id" => $id ]) {

print "結果4 "."id: " .$id." name:".$name ."\n" ;

}

function getList(){

$test = [

["id" => 1,"name" => "田中"]

];

return $test[0];

}

list("name" => $name,"id" => $id) = getList();

print "結果5 "."id: " .$id." name:".$name ."\n" ;

実行結果

結果1 id: 2 name:Fred
結果2 id: 1 name:Tom
結果2 id: 2 name:Fred
結果3 id: 1 name:Tom
結果3 id: 2 name:Fred
結果4 id: 1 name:Tom
結果4 id: 2 name:Fred
結果5 id: 1 name:田中

結果1 id: 2 name:Fred

結果2 id: 1 name:Tom

結果2 id: 2 name:Fred

結果3 id: 1 name:Tom

結果3 id: 2 name:Fred

結果4 id: 1 name:Tom

結果4 id: 2 name:Fred

結果5 id: 1 name:田中

５．最後に
PHP7.0以降に多くの機能が機能が追加されています。
今回紹介した機能以外にも便利な機能が追加されていますので
詳細を知りたい方は下記をチェックしてみてください。

PHP マニュアル
http://php.net/manual/ja/migration70.new-features.php
http://php.net/manual/ja/migration71.new-features.php
http://php.net/manual/ja/migration72.new-features.php

PHP7の新規機能その1

福岡拠点の永嵜です。

現時点(2019/2/25)でのPHPの最新バージョンは7.3です。
PHP7.0リリースの際にパフォーマンスの向上や多くの新機能が追加されていますが、私自身があまり新機能を使えていなかったので新機能について調べました。
このブログでPHP7.0以降に追加された機能をいくつか紹介したいと思います。

１．引数/戻り値の型宣言
関数の引数/戻り値に明示的に型を指定することができるようになりました。
型を指定することで不正な値が渡されるのが防げます。
通常、Nullは許容されませんが型の前にクエスチョンマークをつけるとNullを許容でき指定した型だけでなく Nullも引数/戻り値として使用できるようになります。

サンプルプログラム
引き数 $a、$b、戻り値にint型指定を指定しています。

function getAddValue(?int $a,?int $b):?int{
    return $a + $b;

}

$sum = getAddValue('A',1);

print "合計値は{$sum}です。\n";

function getAddValue(?int $a,?int $b):?int{

return $a + $b;

}

$sum = getAddValue('A',1);

print "合計値は{$sum}です。\n";

実行結果
宣言した型以外(キャスト出来る場合OK)が引数で指定されるとTypeErrorの例外がスローされます。

PHP Fatal error: Uncaught TypeError: Argu
Fatal error: Uncaught TypeError: Argument 1 passed to getAddValue() must be of the type integer or null, string given, called

1 2	PHP Fatal error: Uncaught TypeError: Argu Fatal error: Uncaught TypeError: Argument 1 passed to getAddValue() must be of the type integer or null, string given, called

注意点
引数/戻り値が指定した型にキャストできる場合は、自動的にキャスト変換されて
正常終了します。厳密に型チェックを行いたい場合は、declare(strict_types=1)命令を使用する必要があります。

※PHP５でも型宣言(タイプフィンディング)は使用できましたが、
以下の制約がありました。
・戻り値では型宣言ができない。
・引数で型を宣言できるのは配列/オブジェクトのみ
(int/floatのような型宣言はできない)

指定可能な型は以下の通りです。

型名	概要	使用可能バージョン
bool	真偽値	7.0.0～
float	浮動小数点数	7.0.0～
int	整数	7.0.0～
string	文字列	7.0.0～
array	配列	5.1.0～
callable	コールバック関数	5.4.0～
クラス名	指定したクラス	5.0.0～
インターフェイス名	指定したインターフェイス	5.0.0～
self	そのメソッドが定義されているクラスと同じクラスのインスタンス	5.0.0～
void	戻り値が特に無いことを指定	7.1.0～

２．Null合体演算子
式1 ?? 式2
式1がNullでない場合には式1をそうでない場合は式2を返します。

サンプルプログラム

$message1 = 'こんにちは'."\n";
$message2 = null;

print $message1??'ノーコメント1'."\n";
print $message2??'ノーコメント2'."\n";

$message1 = 'こんにちは'."\n";

$message2 = null;

print $message1??'ノーコメント1'."\n";

print $message2??'ノーコメント2'."\n";

実行結果
$message2はNullのため式2の値が表示されています。

こんにちは
ノーコメント2

1 2	こんにちはノーコメント2

３．宇宙船演算子
2つの式を比較するための演算子です。
左辺<=>右辺
左辺が大きい：戻り値「1」
右辺が大きい：戻り値「-1」
両辺が等しい：戻り値「0」

サンプルプログラム

// 整数値
echo (1 <=> 1) ."\n"; // 0
echo (1 <=> 2)."\n"; // -1
echo (2 <=> 1) ."\n"; // 1

// 浮動小数点数値
echo (1.5 <=> 1.5) ."\n"; // 0
echo (1.5 <=> 2.5) ."\n"; // -1
echo (2.5 <=> 1.5) ."\n"; // 1

// 文字列
echo ("a" <=> "a")."\n"; // 0
echo ("a" <=> "b")."\n"; // -1
echo ("b" <=> "a")."\n"; // 1

// 整数値

echo (1 <=> 1) ."\n"; // 0

echo (1 <=> 2)."\n"; // -1

echo (2 <=> 1) ."\n"; // 1

// 浮動小数点数値

echo (1.5 <=> 1.5) ."\n"; // 0

echo (1.5 <=> 2.5) ."\n"; // -1

echo (2.5 <=> 1.5) ."\n"; // 1

// 文字列

echo ("a" <=> "a")."\n"; // 0

echo ("a" <=> "b")."\n"; // -1

echo ("b" <=> "a")."\n"; // 1

実行結果

-1

４．最後に
今回紹介しきれなかった機能を次回紹介します。

[Laravel]ビュー

福岡拠点の香月です。

今回はビューです。前回のルートとコントローラで呼び出されたURLに対してPHPでのプログラム処理ができるようになりました。
今回はここで実際にデータを集計して、結果を画面に表示したいと思います。この画面表示部分がMVCモデルのV（View）です。
Laravelの標準テンプレートエンジンはBladeとなっています。

それでは早速コントローラの実装です。
前回の実装ではLaravelのようこそ画面を呼び出していましたが、今回は”top”とう名前のテンプレートを使用して画面を表示するようにします。テンプレートファイルは後で作成します。
app/Http/Controllers/TopController.phpファイルを編集します。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Score;
use App\Student;
use App\Subject;
use Input;

class TopController extends Controller
{
    public function index(Request $request)
    {
        $dispday = $request->input('day');
        $days = Score::getDays();
        if (empty($dispday)) {
            $dispday = array_last($days);
        }
        $scores = Score::getList($dispday);
        $subjects = Subject::all();

        $students = [];
        foreach ($scores as $score) {
            $name = $score->family_name . $score->first_name;
            if (!isset($students[$name])) {
                $students[$name] = [];
            }
            $students[$name][$score->subject_id] = $score->score;
        }

        return view('top')
            ->with('days', $days)
            ->with('dispday', $dispday)
            ->with('subjects', $subjects)
            ->with('students', $students);
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Score;

use App\Student;

use App\Subject;

use Input;

class TopController extends Controller

{

public function index(Request $request)

{

$dispday = $request->input('day');

$days = Score::getDays();

if (empty($dispday)) {

$dispday = array_last($days);

}

$scores = Score::getList($dispday);

$subjects = Subject::all();

$students = [];

foreach ($scores as $score) {

$name = $score->family_name . $score->first_name;

if (!isset($students[$name])) {

$students[$name] = [];

}

$students[$name][$score->subject_id] = $score->score;

}

return view('top')

->with('days', $days)

->with('dispday', $dispday)

->with('subjects', $subjects)

->with('students', $students);

}

モデルScoreに追加した2つのメソッドを呼び出して得点に関するデータを取得しています（ソースは後ほど）。$daysには試験実施日の一覧が、$scoresには試験の点数データが入ってきます。
$subjectsでは科目一覧を取得しています。
$studentsは配列として定義していて、続くforeachで点数データ列挙しながら二次元配列を作成します。一次元目に生徒名、二次元目に科目ID、その値として点数を設定しています。
最後にreturn view(‘top’)で画面を呼び出すと同時に、topテンプレート内で使用するデータを->with()で指定しています。（->with()の複数回の呼び出しは、一回の->with()の呼び出しに置き換えることができます。その場合、->with()の引数にはキー、バリューの配列を設定します）

実装の先頭で$request->input(‘day’)を使っています。コントローラメソッド（ここでいうindex()）ではメソッドインジェクション（依存注入機能）を使ってRequestクラスのインスタンスを取得することができ、ユーザーリクエストの内容を利用できます。

次はScoreにメソッドを追加します。app\Score.phpを編集しましょう。

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Score extends Model
{
    public static function getDays()
    {
        $scores = self::select('exam_day')
            ->groupBy('exam_day')
            ->orderBy('exam_day')
            ->get();

        $days = [];
        foreach ($scores as $s) {
            $days[] = date('Y/m/d', strtotime($s->exam_day));
        }
        return $days;
    }

    public static function getList($day)
    {
        $scores = self::whereDate('exam_day', $day)
            ->leftJoin('subjects', 'subject_id', '=', 'subjects.id')
            ->leftJoin('students', 'student_id', '=', 'students.id')
            ->orderBy('student_id')
            ->orderBy('subject_id')
            ->get();

        return $scores;
    }
}

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Score extends Model

{

public static function getDays()

{

$scores = self::select('exam_day')

->groupBy('exam_day')

->orderBy('exam_day')

->get();

$days = [];

foreach ($scores as $s) {

$days[] = date('Y/m/d', strtotime($s->exam_day));

}

return $days;

}

public static function getList($day)

{

$scores = self::whereDate('exam_day', $day)

->leftJoin('subjects', 'subject_id', '=', 'subjects.id')

->leftJoin('students', 'student_id', '=', 'students.id')

->orderBy('student_id')

->orderBy('subject_id')

->get();

return $scores;

}

getDays()では試験日フィールドexam_dayをグルーピングして、日付の昇順に並び替えた結果を取得しています。exam_dayフィールドは時間まで入っているので、日付だけの書式に書き換えて配列に置き換えています。

getList()では引数で指定された試験日だけのデータを取得し、それに対してLEFT OUTER JOINで科目と生徒を連結した結果を返します。

さあ、ここまでくるとあとはビューを作成します。
resource/views/welcome.blade.phpをコピーしてresource/views/top.blade.phpを作成し、中身を編集します。
コントローラの最後で return view(‘top’) を呼び出していましたが、Laravelではこれでresource/viewsフォルダにあるtop.blade.phpの呼び出しと判断してくれます。

<!doctype html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
    <head>
　　　：
    </head>
    <body>
        <div class="flex-center position-ref full-height">
            <div class="content">
                <div class="title m-b-md">
                    Score sheet
                </div>

                @foreach ($days as $day)
                    @if ($dispday == $day)
                        <span class="emphasis">{{ $day }}</span>
                    @else
                        <span><a href="{{ route('top') . '?day=' . $day }}">{{ $day }}</a></span>
                    @endif
                @endforeach

                <table border="1" cellspacing="0" width="100%">
                    <tr>
                        <td></td>
                        @foreach ($subjects as $subject)
                            <td>{{ $subject->name }}</td>
                        @endforeach
                    </tr>
                    @foreach ($students as $name => $student)
                        <tr>
                            <td>{{ $name }}</td>
                        @foreach ($subjects as $subject)
                            <td>{{ $student[$subject->id] }}</td>
                        @endforeach
                        </tr>
                    @endforeach
                </table>
            </div>
        </div>
    <br><br><br>
    </body>
</html>

<!doctype html>

<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">

<head>

　　　：

</head>

<body>

Score sheet

</div>

@foreach ($days as $day)

@if ($dispday == $day)

@else

@endif

@endforeach

<tr>

@foreach ($subjects as $subject)

<td>{{ $subject->name }}</td>

@endforeach

</tr>

@foreach ($students as $name => $student)

<tr>

@foreach ($subjects as $subject)

<td>{{ $student[$subject->id] }}</td>

@endforeach

</tr>

@endforeach

</table>

</div>

</body>

</html>

画面のタイトル「Score sheet」を表示します。
その下には試験日の一覧$daysを@foreachで列挙して表示します。各試験日はaタグでリンクを作成し、クリックするとその日の表示に切り替わるようにしています。ここでroute(‘top’)を呼び出していますが、前回route/web.phpファイル内でRoute::get(‘/’, ‘TopController@index’)->name(‘top’);と指定した名前ですね。これによりこのリンク先が。/ に設定されます。
最後にtableタグで点数表を表示します。縦に生徒軸、横に科目軸を設定して、各生徒の点数を表示するようにしています。それぞれ@foreachでループしながらテーブルを生成しています。

これで実装が完了しました。実際に画面を表示して見ましょう。
表示するデータはシーダーで用意したデータです。
こんな感じで画面が表示されます。

Bladeテンプレートエンジンでは@foreach以外にも@if, @elseや@switch, @case, @breakなどの制御構文が使えます。

また、テンプレートの継承や@includeなど、他のテンプレートファイルと組み合わせて1つの画面を作成することができます。同じ内容を複数のファイルに書くと、後からの編集が大変ですね。その手間をなくすために積極的に活用しましょう。

2025年1月
月	火	水	木	金	土	日
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30	31