One-to-one (hasOne, belongsTo) in Laravel - Mini Project: Build & Apply

One-to-one Relationship with hasOne and belongsTo in Laravel

📖 Scenario: You are building a simple Laravel application to manage users and their profiles. Each user has exactly one profile, and each profile belongs to one user.

🎯 Goal: Create a one-to-one relationship between User and Profile models using hasOne and belongsTo methods in Laravel.

📋 What You'll Learn

Create a User model with a hasOne relationship method named profile

Create a Profile model with a belongsTo relationship method named user

Use the exact method names profile in User and user in Profile

Use the exact class names User and Profile

Use the exact namespace App\Models for both models

💡 Why This Matters

🌍 Real World

One-to-one relationships are common in applications where entities have exclusive linked data, like user accounts and profiles, or products and product details.

💼 Career

Understanding Laravel's relationship methods is essential for backend developers working with databases and building efficient data models.

1

Create the User model with profile method

Create a User model class inside the App\Models namespace. Add a public method called profile that returns a hasOne(Profile::class) relationship.

Laravel

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

// Create User model class with profile() method
# Your code here

Hint

Remember to use hasOne inside the profile method to link to the Profile model.

2

Create the Profile model with user method

Create a Profile model class inside the App\Models namespace. Add a public method called user that returns a belongsTo(User::class) relationship.

Laravel

hasOne(Profile::class);
    }
}

// Create Profile model class with user() method
# Your code here

Hint

Use belongsTo inside the user method to link back to the User model.

3

Add the use statement for Profile in User model

In the User model, add a use App\Models\Profile; statement at the top after the namespace declaration.

Laravel

hasOne(Profile::class);
    }
}

class Profile extends Model
{
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

Hint

Use the full namespace App\Models\Profile in the use statement.

4

Add the use statement for User in Profile model

In the Profile model, add a use App\Models\User; statement at the top after the namespace declaration.

Laravel

hasOne(Profile::class);
    }
}

class Profile extends Model
{
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

Hint

Use the full namespace App\Models\User in the use statement.

Practice

1. In Laravel, when defining a one-to-one relationship, which method should you use on the model that owns the other model?

easy

A. hasOne

B. belongsTo

C. hasMany

D. belongsToMany

Solution

1. Step 1: Understand ownership in one-to-one

   The model that owns the other model is the one that does not have the foreign key.

2. Step 2: Identify the correct method for ownership

   In Laravel, the owning model uses hasOne to define the relationship.

3. Final Answer:

   hasOne -> Option A

4. Quick Check:

   Owning model uses hasOne [OK]

Hint: Owning model uses hasOne, foreign key model uses belongsTo [OK]

Common Mistakes:

• Using belongsTo on the owning model
• Confusing hasOne with hasMany
• Using belongsToMany for one-to-one

2. Which of the following is the correct syntax to define a belongsTo relationship in a Laravel model?

easy

A. public function user() { return $this->belongsTo(User::class); }

B. public function user() { return $this->belongsToMany(User::class); }

C. public function user() { return $this->hasMany(User::class); }

D. public function user() { return $this->hasOne(User::class); }

Solution

1. Step 1: Recall belongsTo syntax

   The belongsTo method is used on the model with the foreign key and is called like return $this->belongsTo(Model::class);.

2. Step 2: Match the correct syntax

   public function user() { return $this->belongsTo(User::class); } matches the correct belongsTo syntax exactly.

3. Final Answer:

   public function user() { return $this->belongsTo(User::class); } -> Option A

4. Quick Check:

   belongsTo syntax uses belongsTo(Model::class) [OK]

Hint: belongsTo uses return $this->belongsTo(Model::class) [OK]

Common Mistakes:

• Using hasOne instead of belongsTo
• Forgetting parentheses after belongsTo
• Using belongsToMany for one-to-one

3. Given these two Laravel models:

class User extends Model {
  public function profile() {
    return $this->hasOne(Profile::class);
  }
}

class Profile extends Model {
  public function user() {
    return $this->belongsTo(User::class);
  }
}

What will $user->profile->phone return if the user has a profile with phone number '123-456-7890'?

medium

A. An array of profiles

B. null

C. An error because profile() is not defined

D. '123-456-7890'

Solution

1. Step 1: Understand the relationship

   User has one Profile, so $user->profile returns the related Profile model instance.

2. Step 2: Access the phone attribute

   Accessing $user->profile->phone returns the phone value from the Profile model, which is '123-456-7890'.

3. Final Answer:

   '123-456-7890' -> Option D

4. Quick Check:

   hasOne returns single related model [OK]

Hint: hasOne returns single model, access attributes directly [OK]

Common Mistakes:

• Expecting an array instead of a single model
• Confusing belongsTo and hasOne roles
• Assuming null when profile exists

4. You have these models:

class Author extends Model {
  public function biography() {
    return $this->hasOne(Biography::class);
  }
}

class Biography extends Model {
  public function author() {
    return $this->belongsTo(Author::class);
  }
}

But when you try $author->biography, it returns null even though the biography exists in the database. What is the most likely cause?

medium

A. The Biography model is missing the hasOne method.

B. The Author model should use belongsTo instead of hasOne.

C. The Biography model's foreign key column name doesn't match Laravel's default 'author_id'.

D. The database table for Biography is missing entirely.

Solution

1. Step 1: Check foreign key conventions

   Laravel expects the foreign key in Biography table to be 'author_id' by default for belongsTo.

2. Step 2: Identify mismatch causes null

   If the foreign key column is named differently, Laravel cannot find the related record, so $author->biography returns null.

3. Final Answer:

   The Biography model's foreign key column name doesn't match Laravel's default 'author_id'. -> Option C

4. Quick Check:

   Foreign key name mismatch causes null relation [OK]

Hint: Check foreign key column names match Laravel defaults [OK]

Common Mistakes:

• Switching hasOne and belongsTo methods incorrectly
• Assuming missing method causes null instead of key mismatch
• Ignoring database schema foreign key names

5. You want to create a one-to-one relationship between Car and Engine models where each car has exactly one engine. The engines table has a foreign key car_id. Which is the correct way to define the relationship in both models?

hard

A. In Car model: public function engine() { return $this->belongsTo(Engine::class); }In Engine model: public function car() { return $this->hasOne(Car::class); }

B. In Car model: public function engine() { return $this->hasOne(Engine::class); }In Engine model: public function car() { return $this->belongsTo(Car::class); }

C. In Car model: public function engine() { return $this->hasMany(Engine::class); }In Engine model: public function car() { return $this->belongsTo(Car::class); }

D. In Car model: public function engine() { return $this->belongsToMany(Engine::class); }In Engine model: public function car() { return $this->belongsToMany(Car::class); }

Solution

1. Step 1: Identify foreign key location

   The foreign key car_id is in the engines table, so Engine belongs to Car.

2. Step 2: Define relationships accordingly

   Car has one Engine (hasOne), Engine belongs to Car (belongsTo).

3. Final Answer:

   Car uses hasOne, Engine uses belongsTo -> Option B

4. Quick Check:

   Foreign key in engines means Engine belongsTo Car [OK]

Hint: Foreign key in table means that model belongsTo owner [OK]

Common Mistakes:

• Reversing hasOne and belongsTo roles
• Using hasMany for one-to-one
• Using belongsToMany for one-to-one