Lesson 4
Managing Employee Records with PHP Classes and Arrays
Introduction

Welcome! Today, we are going to explore an engaging task that involves managing employee records within a company. Specifically, we will work with nested associative arrays and indexed arrays in PHP to add projects and tasks for employees and retrieve those tasks as needed. This exercise will help you understand how to manipulate nested data structures efficiently using PHP.

Introducing Methods to Implement

Let's start by discussing the methods we will implement in our EmployeeRecords class.

  • addProject($employeeId, $projectName) - this method adds a new project to an employee's list of projects. If the project already exists for that employee, the method returns false. Otherwise, it adds the project and returns true.
  • addTask($employeeId, $projectName, $task) - this method adds a new task to a specified project for an employee. If the project does not exist for that employee, the method returns false. If the task is added successfully, it returns true.
  • getTasks($employeeId, $projectName) - this method retrieves all tasks for a specified project of an employee. If the project does not exist for that employee, the method returns an empty array. Otherwise, it returns the list of tasks.
Step 1: Basic Class Structure

Now, let's build our EmployeeRecords class step by step, ensuring we understand each component clearly.

We'll start with the basic structure of the class and initialize our data storage.

php
1<?php 2 3class EmployeeRecords { 4 private $records = []; 5} 6 7// Instantiate the class to ensure it works 8$records = new EmployeeRecords(); 9?>

In this initial setup, we define the EmployeeRecords class and create an instance variable $records that is an associative array. This array will be used to store employee records, where each key is an employee ID and each value is another array holding projects.

Step 2: Implementing 'addProject' Method

Next, we'll implement the addProject method to add projects to an employee's record.

php
1<?php 2 3class EmployeeRecords { 4 private $records = []; 5 6 public function addProject($employeeId, $projectName) { 7 if (isset($this->records[$employeeId][$projectName])) { 8 return false; 9 } else { 10 $this->records[$employeeId][$projectName] = []; 11 return true; 12 } 13 } 14} 15 16// Example usage and testing 17$records = new EmployeeRecords(); 18echo $records->addProject("E123", "ProjectA"); // Returns 1 (true) 19echo $records->addProject("E123", "ProjectA"); // Returns 0 (false) 20?>

Here, the addProject method checks if the given projectName already exists for the employeeId in the $records array. If it does, the method returns false. Otherwise, it initializes an empty array for the project (to hold tasks) and returns true.

Step 3: Implementing 'addTask' Method

Now, we will implement the addTask method. This method relies on the availability of the existing project.

php
1<?php 2 3class EmployeeRecords { 4 private $records = []; 5 6 public function addProject($employeeId, $projectName) { 7 if (isset($this->records[$employeeId][$projectName])) { 8 return false; 9 } else { 10 $this->records[$employeeId][$projectName] = []; 11 return true; 12 } 13 } 14 15 public function addTask($employeeId, $projectName, $task) { 16 if (!isset($this->records[$employeeId][$projectName])) { 17 return false; 18 } 19 $this->records[$employeeId][$projectName][] = $task; 20 return true; 21 } 22} 23 24// Example usage and testing 25$records = new EmployeeRecords(); 26$records->addProject("E123", "ProjectA"); 27echo $records->addTask("E123", "ProjectA", "Task1"); // Returns 1 (true) 28echo $records->addTask("E123", "NonExistentProject", "Task3"); // Returns 0 (false) 29?>

The addTask method first checks if the projectName exists for the employeeId in the $records array. If the check fails, the method returns false. Otherwise, it appends the task to the list of tasks for the specified project and returns true.

Step 4: Implementing 'getTasks' Method

Lastly, let's implement the getTasks method to retrieve tasks from a specified employee's project.

php
1<?php 2 3class EmployeeRecords { 4 private $records = []; 5 6 public function addProject($employeeId, $projectName) { 7 if (isset($this->records[$employeeId][$projectName])) { 8 return false; 9 } else { 10 $this->records[$employeeId][$projectName] = []; 11 return true; 12 } 13 } 14 15 public function addTask($employeeId, $projectName, $task) { 16 if (!isset($this->records[$employeeId][$projectName])) { 17 return false; 18 } 19 $this->records[$employeeId][$projectName][] = $task; 20 return true; 21 } 22 23 public function getTasks($employeeId, $projectName) { 24 if (!isset($this->records[$employeeId][$projectName])) { 25 return []; 26 } 27 return $this->records[$employeeId][$projectName]; 28 } 29} 30 31// Example usage and testing 32$records = new EmployeeRecords(); 33$records->addProject("E123", "ProjectA"); 34$records->addTask("E123", "ProjectA", "Task1"); 35foreach ($records->getTasks("E123", "ProjectA") as $task) { 36 echo $task . "\n"; // Prints "Task1" 37} 38$tasks = $records->getTasks("E123", "NonExistentProject"); 39echo empty($tasks); // Returns 1 (true) 40?>

The getTasks method checks if the projectName exists for the employeeId in the $records array. If the check fails, the method returns an empty array. Otherwise, it returns the list of tasks for the specified project.

Lesson Summary

In this lesson, we successfully implemented the EmployeeRecords class for managing projects and tasks for employees using nested PHP associative arrays and indexed arrays. We covered methods for adding projects, adding tasks to those projects, and retrieving tasks from those projects.

Understanding how to work with nested data structures allows you to efficiently manage complex data hierarchies, which improves your programming skills and problem-solving abilities. I encourage you to practice similar challenges to reinforce what you learned today.

Keep coding and exploring new challenges!

Enjoy this lesson? Now it's time to practice with Cosmo!
Practice is how you turn knowledge into actual skills.