1. HOME
  2. »
  3. プログラミング・Web
  4. »
  5. Pug
  6. »
  7. PugでPHPを使うための、最もスマートで分かりやすい方法

PugでPHPを使うための、最もスマートで分かりやすい方法

HTMLを書くときPugを使うととても便利なのですが、PHPを書きたいと思ったときは少し工夫が必要になります。

ドットや縦棒を使う方法もありますが、無理やり感が否めません。
また、PugでPHPを書くためのプラグインを使う方法もありますが、使うプラグインが増えれば増えるほど管理が大変になるので、あまり使いたくないです。

しかし、フィルターを使うことによって、PugのなかでもPHPをスマートに使うことができます。

そこで今回は、プラグインに頼らずPugでPHPを使う、無理やり感のない方法を紹介します。

目次
  1. 使用するツールについて
  2. フォルダ構成
  3. Pugの中にPHPを書くための、gulpfile.jsの作成
  4. Pugの中にPHPを書く方法
  5. PugをPHPに変換する
  6. まとめ

使用するツールについて

プラグインに頼らないとはいっても、一つ一つ自分で作っていては、本当にやりたいことができなくなってしまうので、多少は使います。

使用するツールは以下の3つです。

  • gulp
  • gulp-pug
  • gulp-rename

npmなどで、適当なフォルダにインストールしてください。
今回はsampleというフォルダにインストールしました。

npmの場合

$ npm init -y
$ npm i gulp gulp-pug gulp-rename -D

yarnの場合

$ yarn init -y
$ yarn add gulp gulp-pug gulp-rename -D

フォルダ構成

主なフォルダ構成は次のようになっています。

sample
    ┣ assets/pug/index.pug
    ┣ gulpfile.js
    ┣ node_modules/
    ┗ package.json

assetsフォルダや、gulpfile.jsなどは、これから作成していきます。

Pugの中にPHPを書くための、gulpfile.jsの作成

つづいて、gulpfile.jsを作成します。

gulpfile.js

const gulp   = require("gulp");
const pug    = require("gulp-pug");
const rename = require('gulp-rename');
 
exports.pug = () => {
	const options = {
		filters: {
			'php': text => {
				text = '<?php ' + text + ' ?>';
				return text;
			}
		}
	};
	return gulp.src( 'assets/pug/*.pug' )
	.pipe( pug( options ) )
	.pipe( rename( {
		extname: '.php'
	} ) )
	.pipe( gulp.dest( 'dist/php/' ) );
}

ここで注目して欲しいのが、6〜13行目のoptionsというオブジェクトです。
filtersを使って、PHPフィルターを使えるようにしています。

さらに、16〜18行目で、拡張子の変換をしています。
これでPugの中にPHPを書くことができるようになります。

Pugの中にPHPを書く方法

では、どうやってPugにPHPを書けばいいのでしょうか。
assets/pug/に、index.pugというファイルを作成し、実際にPHPを書いてみましょう。

assets/pug/index.pug

doctype
html
    head
        title PugでPHPを使う方法
    body
        //-PHPが一行のとき
        :php $animal = "ねこ"

        //-PHPを文の途中で使いたいとき
        p わたしは<?php echo $animal; ?>になりたい。

        //-属性として使いたいとき
        input( type="text" name="name" value!="<?php echo $animal; ?>" )

        //-何行ものPHPを使いたいとき
        :php
            $a = "私は";
            $b = "猫に";
            $c = "なりたい";
            echo $a.$b.$c;

このように、PHPを書きたいところでは:phpを使います。
文の途中や属性としてPHPを使いたい場合は通常通りに<?php ?>を使います。

また13行目のように属性として使う時は、コンパイル時に括弧が変換されてしまいますので、=の前に!をつけます。

PugをPHPに変換する

では、さきほどのソースをPHPに変換してみます。
変換には以下のコマンドを入力します。

npmの場合

$ npx gulp pug

yarnの場合

$ yarn gulp pug

これでさきほどのPugファイルがPHPに変換されます。

<!DOCTYPE html><html><head><title>PugでPHPを使う方法</title></head><body><?php $animal = "ねこ" ?><p>わたしは<?php echo $animal; ?>になりたい。</p><input type="text" name="name" value="<?php echo $animal; ?>"><?php $a = "私は";
$b = "猫に";
$c = "なりたい";
echo $a.$b.$c; ?></body></html>

まとめ

Pugの中でPHPを使うには、ほんの少し工夫が必要になります。
よく見かけるのはドットや縦棒を使う方法ですが、どうしても無理やりな感じがして、私はあまり好きになれませんでした。

今回はフィルターを使うことによってそれを解決してみました。
スマートになりましたでしょうか。

スポンサードリンク

関連コンテンツ

オススメ記事

【Bootstrap 4】badgeを使ってテキスト横に小さな文字を入れる方法

前にBootStrap4の記事を書いていましたが、日にちが空いてしまいましたね。@It_is_Rです。 前回は全体的な機能とアラートの使い方を紹介しました。 今回はバッジの使い方を紹介していき

【webpack 4】npm-scriptsでオリジナルのコマンドを設定する方法

※追記(2018/5/15) 殆ど意味のない例を使っての説明にのちのち後悔し、余分な部分を大幅に削除しました。 畳んだ布団が飼い猫のお気に入りの場所になってます。@It_is_Rです。

WordMove | 運用中の WordPress 環境をローカルと FTP で同期

道が覚えられない、@It_is_Rです。 人生さえ彷徨い続けてここにいます。 さて、運用中の WordPress サイトの環境を、ローカル開発環境と同期したい時、 WordMove を使うとと

Local by Flywheel

Local by Flywheelの使い方。かんたんWordPressローカル環境構築方法

考え事をしていると、目が上にいっている@It_is_Rです。 Local by FlywheelはWordPressのローカル開発環境を簡単に作れるツールです。 今回はこれを使って、ローカルに

プログラミングのクラスってなぁに?

小学生からのJavaScript。クラスの概念をしっかりと理解しよう!

小学生からのプログラミング講座(こうざ)、第12弾です。 前回はマップ上をキャラクターが自由に動くことができるようにしました。 今回はES6から使われるようになった「ク

【Android Studio】 GridLayout の使い方。複雑なレイアウトを表現する方法

スマホの充電がいつの間にか無くなっている@It_is_Rです。 Androidアプリ開発、10回目となりました。 前回、様々なレイアウトの使い方を紹介しましたが、今回はその中でもちょっと難しい

webpack-dev-serverの基本的な使い方と設定方法の詳しい解説

あとで見ようとブラウザのタブを開きすぎて、どれがどれだか分からなくなる@It_is_Rです。 webpack-dev-serverを使えば、とても簡単にwebpackでの開発サーバーを立ち上げる

enchant.js100行未満!!本格シューティングゲーム作り方。

昨日歩き回ったせいで、足がかなり痛い@It_is_Rです。 さて、今回はenchant.jsのネタです。enchant.jsを使うと、javascriptのプログラムがものすごく簡単に書けてしま

【Xcode7】Swift2でMacアプリ開発。Storyboardでボタンを作る。

喧嘩するほど仲がいいとは言いますが、喧嘩する相手がいません。友達がいないということでしょうか。@It_is_Rです。 前回、StoryboardでMacのウィンドウに文字を表示しました。しかし、

carousel

【Bootstrap 4】くるくる回転するUI、カルーセル機能のを実装方法!

Bootstrap4の使い方、第8回目です。 サイトをみていると、画像を横並びにしてくるくると回転するカルーセル機能を実装しているサイトがありますよね。 Bootstrap4には、カルーセルを

コメントをどうぞ!

メールアドレスが公開されることはありません。