質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

新規登録して質問してみよう
ただいま回答率
85.48%
PHP

PHPは、Webサイト構築に特化して開発されたプログラミング言語です。大きな特徴のひとつは、HTMLに直接プログラムを埋め込むことができるという点です。PHPを用いることで、HTMLを動的コンテンツとして出力できます。HTMLがそのままブラウザに表示されるのに対し、PHPプログラムはサーバ側で実行された結果がブラウザに表示されるため、PHPスクリプトは「サーバサイドスクリプト」と呼ばれています。

命名規則

命名規則は、プログラミングする際に識別子の名称である文字列を決める表記法のことです。ネーミング規則・ネーミング規約・命名規約とも呼びます。

Q&A

解決済

6回答

7702閲覧

変数名の付け方に時間がかかる

coffee

総合スコア139

PHP

PHPは、Webサイト構築に特化して開発されたプログラミング言語です。大きな特徴のひとつは、HTMLに直接プログラムを埋め込むことができるという点です。PHPを用いることで、HTMLを動的コンテンツとして出力できます。HTMLがそのままブラウザに表示されるのに対し、PHPプログラムはサーバ側で実行された結果がブラウザに表示されるため、PHPスクリプトは「サーバサイドスクリプト」と呼ばれています。

命名規則

命名規則は、プログラミングする際に識別子の名称である文字列を決める表記法のことです。ネーミング規則・ネーミング規約・命名規約とも呼びます。

0グッド

18クリップ

投稿2015/03/17 06:27

すごい初歩的な質問なのですが、いつも変数名やメソッド名などを付けるのに悩み、そこに結構時間が取られてしまいます。

シンプルで分かりやすい名前をすぐに付けれるようになるにはどういった訓練をすればよいのでしょうか。

気になる質問をクリップする

クリップした質問は、後からいつでもMYページで確認できます。

またクリップした質問に回答があった際、通知やメールを受け取ることができます。

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

guest

回答6

0

ベストアンサー

どの言語にも言えますが、まずはその言語に最初から実装されている関数名等に倣うことです。
次に、PHPならPEAR等のライブラリがありますが、それらのソースを見て、どのような付け方をしているかを見るのがよろしいと思います。

以下、私がよく使う例ですので、参考にして下さい。

・毎日投稿されるコメントを集計目的でユーザーID指定で取得する
getDailyCommentForSummaryByUserId($userId)
※ByをWithにする方もおられますね。

・コメント操作など
addComment($comment) //追加
deleteComment($commentId) もしくは removeComment, eraseCommentなど//削除
setComment($commentId,$comment) もしくは replaceCommentなど//再編集

・ユーザーが存在するか
isUserExist($userId)

・ユーザーはプレミアム機能を使えるか
isPremiumUser($userId)
もしくは
canUserUsePremiumFunction($userId)

いずれにせよメソッド名の冒頭だけ見て、どのような処理をするか、どのような型が返ってくるか、を類推できることが重要です。
メソッド内部の変数はもう好きにして構わないと思います。

投稿2015/03/17 06:41

編集2015/03/17 07:18
terushu

総合スコア358

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

日本語から適切な英語に変換する際に悩んでいるのであれば
http://codic.jp/
のようなサイトを利用するのも手です。

投稿2015/03/17 06:39

k.tada

総合スコア1679

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

基本的な操作の単語はまず覚えておいた方がいいと思います。
操作
add,delete,update,create,get,put,open,close,remove ...
判定
is,can,has ...
位置
first,last,next,prev(iouse) ...
対象
all, first, last, 単数複数(getUser(), getUsers()) ...

ただ分かりやすいって見る人で変わります。先日、
LogWhere()
というのがあって、なんじゃこれと思いましたが、これで分かるという人もいました。
自分なら、
makeLogSearchConditionString()
だったんですが。難しいものです。

投稿2015/06/08 20:54

tetsuyakuniyuki

総合スコア24

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

私の場合は、すぐ思いつくことを諦めて、後で考えるようにしています。

コメントの中に TODO: などと記載しておいて、一日の作業を終える時に全て見直します。

分かりやすい変数名にする理由は、新しくコードを書くときのためではなく、後でコードを読み直す時のためですから、これは理にかなった方法だと思っています。

投稿2015/03/17 09:13

lichten

総合スコア133

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

他人のコードをたくさん読むのが良いですね。
そして、自分なりに書き換えてみるのです。(どんなコードにも、改善の余地はあります。)
その中で、そのコードを書いた人の思いを想像します。
なぜ、このメソッドはこの名前なのか。なぜ、この変数はこの名前なのか。
慣れてくると、ああ、ここは手抜きだな、とかわかるようになります。

投稿2015/03/17 08:10

chokojori

総合スコア971

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

0

こんにちは。

PEAR::Manualの命名規約(リンク)や、Zend Frameworkの命名規約(リンク)を参考にしながら、
1)変数名に含めることができるのは英数字のみ(ただし、数字はおすすめできない)
2)つねに小文字ではじめる(グローバル変数の場合はアンダースコアからはじめる)
3)複数の単語で構成する場合は各単語の最初の文字を大文字にする
4)変数名は省略しすぎない(すくなくとも自分が何カ月か後にみた場合に意味がわかるていどに)
などといったことを意識しつつ命名することがだいじだと思います。

terushuさんの回答に書かれている例がとてもわかりやすいですね。

投稿2015/03/17 07:08

退会済みユーザー

退会済みユーザー

総合スコア0

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

あなたの回答

tips

太字

斜体

打ち消し線

見出し

引用テキストの挿入

コードの挿入

リンクの挿入

リストの挿入

番号リストの挿入

表の挿入

水平線の挿入

プレビュー

15分調べてもわからないことは
teratailで質問しよう!

ただいまの回答率
85.48%

質問をまとめることで
思考を整理して素早く解決

テンプレート機能で
簡単に質問をまとめる

質問する

関連した質問