Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zahidrahimoon/phpoop
https://github.com/zahidrahimoon/phpoop
Last synced: 7 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/zahidrahimoon/phpoop
- Owner: zahidrahimoon
- License: mit
- Created: 2024-08-18T09:50:17.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2024-08-18T17:20:10.000Z (3 months ago)
- Last Synced: 2024-08-19T11:27:47.383Z (3 months ago)
- Language: PHP
- Size: 17.6 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📦 INVENTARY MANAGEMENT SYSTEM
## 📋 Overview
This project is a CRUD (Create, Read, Update, Delete) application built using **PHP Data Objects (PDO)** with **Object-Oriented Programming (OOP)** principles. The application manages a simple inventory system by interacting with a MySQL database, handling basic product information like name, description, price, and quantity.
## 🛠️ Features
- **Create**: Add new products to the inventory.
- **Read**: Display all products in a tabular format.
- **Update**: Edit product details.
- **Delete**: Remove products with a confirmation prompt.
## 📂 File Structure
```bash
.
├── config/
│ └── db.php # Database connection file
├── crud/
│ ├── create.php # Create product page
│ ├── delete.php # Delete product page
│ ├── Product.php # Product class with CRUD methods
│ ├── read.php # Read products page
│ └── update.php # Update product page
├── index.php # Main page to list all products
└── README.md # Project documentation (this file)
```
## 🗂️ Database Setup
### 1. Create Database
First, create a MySQL database named `inventory`:
```sql
CREATE DATABASE inventory;
```
### 2. Create `products` Table
Run the following SQL script to create the `products` table:
```sql
USE inventory;
CREATE TABLE `products` (
`id` INT AUTO_INCREMENT PRIMARY KEY,
`name` VARCHAR(100) NOT NULL,
`description` TEXT,
`price` DECIMAL(10,2) NOT NULL,
`quantity` INT NOT NULL,
`created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```
## 🚀 Getting Started
### 1. Clone the Repository
```bash
git clone https://github.com/zahidrahimoon/PHPOOP.git
cd PHPOOP
```
### 2. Setup Database Connection
Navigate to `config/db.php` and update the database credentials:
```php
conn = null;
try {
$this->conn = new PDO("mysql:host={$this->host};dbname={$this->db_name}", $this->username, $this->password);
$this->conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
echo 'Connection Error: ' . $e->getMessage();
}
return $this->conn;
}
}
```
### 3. Run the Application
- Start your local server (e.g., using XAMPP, MAMP, or LAMP).
- Access the application by navigating to `http://localhost/PHPOOP/index.php` in your browser.
## 🔧 CRUD Operations
### Create
To add a new product:
- Navigate to `http://localhost/PHPOOP/crud/create.php`.
- Fill in the product details and submit the form.
### Read
To view all products:
- Navigate to `http://localhost/PHPOOP/index.php`.
### Update
To update a product:
- Click on the `Edit` button for the desired product on the main page.
- Make necessary changes and submit the form.
### Delete
To delete a product:
- Click on the `Delete` button for the desired product on the main page.
- Confirm the deletion to remove the product from the database.
## 🧩 Classes and Methods
### Database Class
- **Properties**:
- `$host`: Database host.
- `$db_name`: Database name.
- `$username`: Database username.
- `$password`: Database password.
- `$conn`: Connection variable.
- **Methods**:
- `connect()`: Establishes and returns the PDO connection.
### Product Class
- **Properties**:
- `$id`: Product ID.
- `$name`: Product name.
- `$description`: Product description.
- `$price`: Product price.
- `$quantity`: Product quantity.
- **Methods**:
- `create()`: Inserts a new product into the database.
- `read()`: Fetches all products from the database.
- `update()`: Updates the product information.
- `delete()`: Deletes a product from the database.
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.