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

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

ただいまの
回答率

90.48%

  • PHP

    20782questions

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

データを受け取るメソッドの命名について

解決済

回答 2

投稿

  • 評価
  • クリップ 0
  • VIEW 233

asatake

score 8

 前提

  • プロジェクトはMVCで構成

  • モデルのプライベートメソッドでDBから該当データを取得し、配列で返す

  • 同一モデルのパブリックメソッドから上のプライベートメソッドを呼び出し、受け取った配列を少し整形して配列で返す

この2つのメソッドがモデルあり、コントローラからパブリックメソッドを呼び出して、その後ソートなどを行い、ビューに渡します。
つまり、
View --> Controller --> Model::publicMethod --> Model::privateMethod
のような構成です。

 わからない点

例えばDBからデータを取得するプライベートメソッドが

private function fetchDatas(int $id) : array
{
/* sqlを実行する処理 */
...
}


のように命名されているとき、パブリックメソッドにはどう命名するのが適切なのでしょうか。
パブリックメソッドはgetterではないのでget〜とつけるのは間違いだとは思うのですが…。

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

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

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

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • mts10806

    2017/09/12 13:04

    一応、「正解はない」ということは理解の上ですよね?プロジェクト的な命名規則はありますか?

    キャンセル

  • asatake

    2017/09/12 13:08

    そうですね、命名の例がほしいという感じです。命名規則は特に無いです。

    キャンセル

  • mts10806

    2017/09/12 13:31

    モデルの役割とパブリックメソッドの用途によりますね。場合により現在ご提示のfetchDatas()はprivateである必要がないかもしれませんし。id渡されてるので1件に絞ることが目的のようにも思えますし。

    キャンセル

回答 2

checkベストアンサー

0

get~でも問題ないと思います。
動詞よりも名詞に気をつけたほうがよいかと思います。

名前のつけかたの基準は基本的には外部に公開する一番便利なメソッドと
内部で使う汎用的なメソッドで名前を考えることがよいかと思います。

たとえば食べ物屋とかで注文するのをイメージしてみてください。
お客は作り方の詳細はしらないけど、注文したものがでてくればよくて、
調理場は、作り方を知っている必要があります。

publicは、お客さんが注文をするときの名前で、呼び出す側が内部のことをしらなくても
使えるような名前になっていたほうがよいです。

privateは内部から呼び出すものなので、より詳細の作業かつ汎用的な名前になるかと思います。
場合によっては、builderみたいな専用の処理を用意する場合もあります

結果的にprivateとpublicが同じ名前になっても問題はないかと思います。
とはいえ、今回のケースで「fetchData」がpublicにはなるのは名前の意図がわからないのでNGかと。

public get牛丼() {
  return make牛丼();
}

public get牛丼セット() {
  return make牛丼().add(makeサラダ);
}

private make牛丼() {}
private makeサラダ() {}

あとは、DB検索系に使う動詞だと、想定する検索結果件数の違いで名前をわけることがあります。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

0

http://qiita.com/AKB428/items/20e81ccc8d9998b5535d
http://tech.mof-mof.co.jp/blog/method-name.html
上記のページが参考になるかもしれません。
誰(何)が何をするか、どんな値が返ってきそうかなどを考えながら命名すると良いかもしれません。

datum→data(http://ejje.weblio.jp/content/datum)なのでdatasは微妙かもしれません。

dbからの取得なのでgetよりかはfetchのが命名として望ましいかと。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

関連した質問

  • 解決済

    cakePHPの2.5でパスワードが暗号化されない

    cakePHPのバージョン2.5を使ってAuthコンポーネントで認証をつけようとしています。 さくらインターネットを利用しているのですが、 usersテーブルのパスワードが

  • 解決済

    session_set_save_handler指定するのは、SessionHandlerInter...

    質問1.session_set_save_handlerはどこで指定するの? 例Aと例Bは同義? ・それぞれのメリットデメリットを教えてください 例A class

  • 解決済

    Laravel5.2 join

    お世話になります! 以下のようなテーブル構成で注文の一覧を取得したい場合、 Modelを使ってうまく取得したいのですが定義の仕方やイメージがわきません。。 ヒントになるよ

  • 受付中

    PHP classの継承

    PHPのclassで継承処理を行う際、例えばAクラスのpublic $aの変数へBクラスからアクセスすることは可能なんでしょうか BクラスでAクラスのpublic $aを引数

  • 解決済

    PHP動的に処理したい

    補足情報(言語/FW/ツール等のバージョンなど) PHP5.4 前提・実現したいこと PHPで汎用的な処理をしたいのですが、いまいち書き方がわからないので質問させてく

  • 解決済

    【Laravel 5.4】リレーションができない。

    前提・実現したいこと リレーションしたメソッドの情報全てをコントローラーに持ってきたいのですが、 多分whereHasを使うのかなと思ったのですが、 whereHasの使い方がわか

  • 解決済

    【Laravel】ソフトデリートカラムのカスタマイズ

    テーブルにdeleted_atカラムを追加するソフトデリート機能を有効にできると思いますが、 このカラム名をdelete_flag(1=削除)のように独自のカラムに変更することは可

  • 解決済

    どうして、真になるのか

    下記のようにシングルトンパターンでインスタンスを作ると class single { private static $singleton; public static f

同じタグがついた質問を見る

  • PHP

    20782questions

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