Laravelのモデルファイル内の関数はいつ実行されている？

Question

###初歩的な質問：Laravelのモデルファイル内の関数はいつ実行されている？

現在Laravelチュートリアルを行っていて
モデルファイルでアクセサを作成する関数を作成しました。

以下のコードがそれです。

関数は定義しただけじゃ実行されず、呼び出すことで初めて実行され戻り値を取得できるという認識なのですが
このモデルファイルで定義した関数は、他のどのファイル（blade.php, web.php）でも呼び出されていません。
しかし、blade.php内でstatus_labelやstatus_classを利用できることから呼び出してないのにどうして？という疑問が浮かび
モデルファイル内の関数について優しく教えていただきたいです。

私の認識
・モデルファイル内の関数は自動で実行される
・コントローラーファイル内の関数はweb.phpで呼び出しされ初めて実行される

models

<?php

namespace App\Models;

use Carbon\Carbon;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Task extends Model
{
    /**
     *  状態定義
     */

    const STATUS = [
        1 => ['label' => '未着手', 'class' => 'label-danger'],
        2 => ['label' => '着手中', 'class' => 'label-info'],
        3 => ['label' => '完了', 'class' => ''],
    ];

    /**
     * 状態のラベル
     * @return string
     */
    public function getStatusLabelAttribute()
    {
        // 状態値 該当のstatusカラムの値を取得
        $status = $this->attributes['status'];

        // 定義されていない場合空文字を返す
        if (!isset(self::STATUS[$status])) {
            return '';
        }

        return self::STATUS[$status]['label'];
    }

    /**
     * 状態を表すHTMLクラス
     * @return string
     */
    public function getStatusClassAttribute()
    {
        // 状態値
        $status = $this->attributes['status'];

        // 定義されていない場合空文字を返す
        if (!isset(self::STATUS[$status])) {
            return '';
        }

        return self::STATUS[$status]['class'];
    }

    /**
     * 整形した期限日
     * @return string
     */

    public function getFormattedDueDateAttribute()
    {
        return Carbon::createFromFormat('Y-m-d', $this->attributes['due_date'])->format('Y/m/d');
    }

    use HasFactory;
}

blade

<!-- views/tasks/index.blade.php -->

@extends('layout')

@section('content')
<div class="container">
    <div class="row">
        <div class="col col-md-4">
            <nav class="panel panel-default">
                <div class="panel-heading">フォルダ</div>
                <div class="panel-body">
                    <a href="{{ route('folders.create') }}" class="btn btn-default btn-block">
                        フォルダを追加する
                    </a>
                </div>
                <div class="list-group">
                    @foreach($folders as $folder)
                    <a href="{{ route('tasks.index', ['id' => $folder->id]) }}" class="list-group-item {{ $current_folder_id === $folder->id ? 'active' : '' }}">
                        {{ $folder->title }}
                    </a>
                    @endforeach
                </div>
            </nav>
        </div>
        <div class="column col-md-8">
            <div class="panel panel-default">
                <div class="panel-heading">タスク</div>
                <div class="panel-body">
                    <div class="text-right">
                        <a href="{{ route('tasks.create', ['id' => $current_folder_id]) }}" class="btn btn-default btn-block">
                            タスクを追加する
                        </a>
                    </div>
                </div>
                <table class="table">
                    <thead>
                        <tr>
                            <th>タイトル</th>
                            <th>状態</th>
                            <th>期限</th>
                            <th></th>
                        </tr>
                    </thead>
                    <tbody>
                        @foreach($tasks as $task)
                        <tr>
                            <td>{{ $task->title }}</td>
                            <td>
                                <span class="label {{ $task->status_class }}">{{ $task->status_label }}</span>
                            </td>
                            <td>{{ $task->formatted_due_date }}</td>
                            <td><a href="{{ route('tasks.edit', ['id' => $task->folder_id, 'task_id' => $task->id]) }}">編集</a></td>
                        </tr>
                        @endforeach
                    </tbody>
                </table>
            </div>
        </div>
    </div>
</div>
@endsection

<?php

namespace App\Http\Controllers;

use App\Http\Requests\CreateTask;
use App\Http\Requests\EditTask;
use App\Models\Folder;
use App\Models\Task;
use Illuminate\Http\Request;

class TaskController extends Controller
{
    public function index(int $id)
    {
        // Folderテーブルから全データを取得
        $folders = Folder::all();

        // Folderテーブルから選ばれたフォルダを取得する
        $current_folder = Folder::find($id);

        // 選ばれたフォルダに紐づくタスクを取得する
        // $tasks = Task::where('folder_id', $current_folder->id)->get();
        $tasks = $current_folder->tasks()->get();

        return view('tasks/index', [
            'folders' => $folders,
            'current_folder_id' => $current_folder->id,
            'tasks' => $tasks,
        ]);
    }

    /**
     * GET /folders/{id}/tasks/create
     */
    public function showCreateForm(int $id)
    {
        return view('tasks/create', [
            'folder_id' => $id,
        ]);
    }

    public function create(int $id, CreateTask $request)
    {
        $current_folder = Folder::find($id);

        $task = new Task();
        $task->title = $request->title;
        $task->due_date = $request->due_date;

        $current_folder->tasks()->save($task);

        return redirect()->route('tasks.index', [
            'id' => $current_folder->id,
        ]);
    }

    /**
     * GET /folders/{id}/tasks/{task_id}/edit
     */
    public function showEditForm(int $id, int $task_id)
    {
        $task = Task::find($task_id);

        return view('tasks/edit', [
            'task' => $task,
        ]);
    }

    public function edit(int $id, int $task_id, EditTask $request)
    {
        // 1 過去に登録されている情報を取得
        $task = Task::find($task_id);

        // 2
        $task->title = $request->title;
        $task->status = $request->status;
        $task->due_date = $request->due_date;
        $task->save();

        // 3
        return redirect()->route('tasks.index', [
            'id' => $task->folder_id,
        ]);
    }
}

Comments

[phper.k]

Blade内でどの様な記述をしているのかを提示してください

[ChickBeans]

回答ありがとうございます！
bladeを追加いたしました！

[phper.k]

質問内容と矛盾してますね。
Controller にモデルを呼び出すコード書いてません？

[ChickBeans]

回答ありがとうございます！

私の理解度が低すぎてなにが矛盾してるのかさえわからない状況です、、、。

コントローラーでモデルを呼び出すコードは書いているんですけど
モデル内の関数は使用していません。
コントローラーのソースも追記いたしました。

[phper.k]

とりあえず、先につけてある解答の手順は試したんでしょうか？

[ChickBeans]

試したのですが、どこを見ればよいかわからず断念しました。

何度も質問をして申し訳ないですが
原則、モデルに関数を記述するだけでは実行されないという認識で良いのでしょうか？

Answer 1

    public function getStatusLabelAttribute()
    {
        var_dump(debug_backtrace()); // debug_backtrace 

        // 状態値 該当のstatusカラムの値を取得
        $status = $this->attributes['status'];

        // 定義されていない場合空文字を返す
        if (!isset(self::STATUS[$status])) {
            return '';
        }

        return self::STATUS[$status]['label'];
    }

こんなふうに、debug_backtrace を仕込んでおけば、関数の実行順が表示されるので、それでわかると思います。

---

追記を受けて

原則、モデルに関数を記述するだけでは実行されないという認識で良いのでしょうか？

当然です。Laravelに限らず、プログラミング言語において共通です。

関数は呼び出さない限り実行されません。

blade.php内でstatus_labelやstatus_classを利用できることから呼び出してないのにどうして？

「呼び出していない」という認識が誤りで、「呼び出している」から値が取れています。

Answer 2

関数は定義しただけじゃ実行されず、呼び出すことで初めて実行され戻り値を取得できるという認識なのですが

このモデルファイルで定義した関数は、他のどのファイル（blade.php, web.php）でも呼び出されていません。

PHPのインスタンスには存在しないプロパティにアクセスした場合に、別のメソッドにフォールバックするマジックメソッド__getが用意されています。

アクセサで定義したメソッドはこの__get経由でLaravelの内部で呼び出されています。
そのため、いつ発火したかという問いへの返答は存在しないプロパティにアクセスした時かつ対応する命名規則のメソッドが定義されている時です。