Огнеупорный Таракан

В целом стандартом для документирования API сейчас можно назвать Swagger.io. Для него, в свою очередь, можно найти пакеты как для интеграции его и Laravel, так и для преобразования его yaml-файлов в файлы с markdown-разметкой. Намного больше решений можно найти в Google по запросам вроде "swagger.io laravel", "swagger.io markdown" и т.д.

protected $with = array('user', 'category', 'isOwner');

isOwner оттуда убирайте и читайте доки по моделям.

То, что вы хотите для isOwner:
protected $appends = ['isOwner'];

debug_backtrace() вернёт массив стека вызова.

Соотв. вызывавшая нынешнюю функцию окажется под индексом 1:

function A() {	Foo(); }
function B() {	Foo(); }

function Foo() {
	$stack = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
	if( count($stack) > 1) echo "Меня вызвали из " . $stack[1]['function'] . PHP_EOL;
}

A(); // попробуйте поменять на B();
// Меня вызвали из A

Человеческий стиль: (сущность, действие, объект действия)

$user->like->photo($photoId);
$user->like->profile($profileId);
$user->like->comment($commentId);

лайки штука интересная. Для начала сам по себе "лайк" это не сущность, это связь между пользователем и фотографией. Идем дальше.

Сущность юзера должна знать о лайках? Скорее всего нет. Сущность которую лайкают должна знать о лайках? По сути тоже нет, но это удобно. Потому пусть будет так.

Итого минимум который нам нужен для того что бы сделай лайки - это одностороння many-to-many связь. Если брать например Doctrine реализация будет примерно такой:

class Photo {
    /**
     * @type User[]|ArrayCollection
     */
    private $likes;

    public function __construct(/** ... */) {
        // тут какой-то еще код
        $this->likes = new ArrayCollection();
    }

    // ... другая логика

    public function like(User $user)
    {
          $this->likes->add($user);
    }
}

Итого имеем интерфейс:

$photo->like($user);

мол мы отправляем сообщение объекту $photo что он кому-то нравится, и передаем кому. А тот уже сам внутри все разрулит.

Поскольку вы захотели сделать Like сущностью, подозреваю что вы хотите знать еще дополнительную информацию вроде "когда кто-то что-то лайкнул" и т.д. Зачем - не мое дело. Но просто давайте чуть изменим имплементацию метода не меняя интерфейса:

public function like(User $user) 
{
    $this->likes->add(Like::photo($this, $user));
}

тут я понятия не имею о том как вы могли захотеть реализовать саму сущность лайков и потому воспользовался статическим методом фабрикой, которая разрулит все внутри.

Еще такой интересный момент, что мы можем все методы вроде `isLikedBy` и т.д. вынести прямо в сущность при желании. Для этого в случае доктрины можно воспользоваться extra lazy ассоциациями и методом matching у коллекции которая вместо обхода объектов может и sql выполнить по критерии какой-то.

Ну и что бы совсем закончить. Пока у нас корнем агрегата сущностей (состоящего из Photo и User) корнем выступает сущность Photo. Но может статься так что лайки у нас могут быть еще сложнее. Например нам надо учитывать репосты и считать количество лайков из этого расчета (как вконтактике например). Тогда с реляционной базой мы быстро начинаем проигрывать и мы можем взять Neo4J например для того что бы хранить лайки как граф. Тогда все удобно и быстро. И тогда можно вытащить логику работы с лайками наверх так что сущности сами о ней вообще ничего не будут знать.

Но это наверное уже совсем другая история.