【CakePHP入門】linkメソッドの使い方(HtmlHelper)

こんにちは!フリーエンジニアのヤマシタです。

CakePHPには、HTMLに関連するオプションを簡単に使用することができるHtmlHelperという機能があります。

この記事では、

・HtmlHelperとは?
・HtmlHelperのlinkメソッドとは
・HtmlHelperのlinkメソッドの基本的な使い方

という基本的な内容から、

・ページ内のリンクを作成する方法
・URLにクエリ文字列を指定する方法

などの応用的な使い方について解説します。

ここではHtmlHelperのlinkメソッドについて、詳しく解説していきます!

HtmlHelperとは

HtmlHelperとは、さまざまなHTMLのタグを作成するための機能です。

HtmlHelperを使用すれば、HTMLのリンクを作成したり画像を出力するなど、HTMLに関連するさまざまなオプションを簡単に使用できる便利な機能です。

HtmlHelperには、さまざまなメソッドが用意されています。

例えば、文字コードを指定する場合は以下のように記述します。

HtmlHelperの使い方

linkメソッドとは

HtmlHelperのlinkメソッドは、アクションを実行したときに指定したURLへ移動するための機能です。

linkメソッドは、以下のように2種類の記述方法があります。

1つ目のオプションを指定すればタグの属性を指定したり、絶対URLを指定することもできます。

2つ目については、クエリ文字列を指定するの章で詳しく取り上げます。

linkメソッドの使い方

ここではHtmlHelperの数あるメソッドでも使用頻度の高いlinkメソッドを使用して、リンク付きのボタンを作成してみましょう。

以下にHtmlHelperのlinkメソッドを使用した、サンプルを記述します。

Cake/src/Controller/SampleController.php

Cake/src/Template/Sample/index.ctp

このプログラムを実行すると、「Samurai」ボタンのある画面が表示されます。

「Samurai」ボタンをクリックすると、侍エンジニアのホームページに飛ぶことができます。

これはHtmlHelperのlinkメソッド使用時に、HTMLで以下のようにURLのリンクが指定されたボタンが作成されるためです。

ページ内リンクを作成する

linkメソッドでは、ページ内のリンクを作成することもできます。

先述したURL同様にlinkメソッドの第二引数に、ページのパスを指定します。

このサンプルでは、パス「/home/samurai」へのリンク付きのボタンが生成されます。

なお、app名称の部分にはcakePHPをインストールしたフォルダ名が反映されます。

クエリ文字列を指定する

linkメソッドでは、クライアントからWebサーバへ送信するときに渡すパラメータ(クエリ文字列)を指定することができます。

クエリ文字列は、以下のように指定します。

このサンプルを実行すると、htmlには以下のように出力されます。

URLの末尾に指定したデータが反映されていることがわかりますね!

まとめ

ここではHtmlHelperのlinkメソッドを使用した、URLの指定方法やページ内リンクの指定方法、クエリ文字列を指定する方法などについて解説しました。

HtmlHelperの数あるメソッドの中でも、linkメソッドは使用する頻度が高いと言えますので、この機会にぜひ覚えておきましょう。

もし、linkメソッドの使い方を忘れてしまったら、この記事を思い出してくださいね。

LINEで送る
Pocket

最短でエンジニアを目指すなら侍エンジニア塾

cta_under_bnr

侍エンジニア塾は業界で初めてマンツーマンレッスンを始めたプログラミングスクールです。これまでの指導実績は16,000名を超え、未経験から数多くのエンジニアを輩出しています。

あなたの目的に合わせてカリキュラムを作成し、現役エンジニア講師が専属であなたの学習をサポートするため効率よく学習を進めることができますよ。

無理な勧誘などは一切ありません。まずは無料体験レッスンを受講ください。

無料体験レッスンの詳細はこちら

書いた人

ヤマシタ

エンジニア歴10年のフリーランスエンジニア。ITに関わるさまざまなコンテンツの企画・制作も行っています。
ITに関してはノウハウ系、ライフハック系、トレンド系など、200本以上の執筆経験があります。

おすすめコンテンツ

あなたにぴったりなプログラミング学習プランを無料で診断!

プログラミング学習の効率を劇的に上げる学習メソッドを解説