Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sloharkar/currency-converter-php-laravel-framework
Currency Converter PHP Laravel Framework
https://github.com/sloharkar/currency-converter-php-laravel-framework
backend-development currency-converter currency-exchange-rates currencyconverter fullstack-development laravel laravel-framework mvc-framework php php-framework php-framework-laravel php-mvc web-application
Last synced: about 20 hours ago
JSON representation
Currency Converter PHP Laravel Framework
- Host: GitHub
- URL: https://github.com/sloharkar/currency-converter-php-laravel-framework
- Owner: SLoharkar
- Created: 2024-08-07T14:44:41.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-08-13T05:59:40.000Z (about 1 month ago)
- Last Synced: 2024-09-23T16:02:12.395Z (2 days ago)
- Topics: backend-development, currency-converter, currency-exchange-rates, currencyconverter, fullstack-development, laravel, laravel-framework, mvc-framework, php, php-framework, php-framework-laravel, php-mvc, web-application
- Language: PHP
- Homepage: https://github.com/SLoharkar/Currency-Converter-PHP-Laravel-Framework
- Size: 57.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Currency Converter PHP Framework Laravel Application
A robust currency converter application built with Laravel 10. This application provides multiple data source options, user roles with specific permissions, and extensive features for both normal users and admin users.
## Website Trailer
Check out the trailer for a quick overview of what the Currency Converter Application can do!
https://github.com/user-attachments/assets/5faebda6-5560-4e8e-b880-bb2121e44238
## Features
- **Data Source Options**:
- Excel
- Default through floatrates website
- Database
- **Currency Conversion**:
- Convert all available currencies with limit options
- Export currencies in Excel and database
- **User Roles**:
- Normal User: Access to dashboard and currency converter with default data source
- Admin User: Manage data sources (Excel and database), export currencies, user management, and IP management
- **User Management**:
- Delete, update users
- Register users
- Reset password functionality
- Remember Me functionality
- **IP Management**:
- Add, delete, update IPs
- **Security**:
- IP restriction for normal users
- Authentication with hashed passwords
- **Database**:
- Database migration at startup
- MySQL
- **Development Practices**:
- Laravel MVC architecture (Model, View, Controller)
- Custom requests
- Global environment variables
- Laravel doc commenting
- Laravel logging
- Laravel Blade template engine
- Controller, Model, Service, and Repository pattern
- Middleware for authentication
- Laravel validation
## Prerequisites
- **PHP**: Ensure you have PHP 7.4 installed.
- **Composer**: Ensure you have Composer installed.
- **XAMPP**: Ensure you have XAMPP installed and running.
- **Laravel**: Ensure you have Laravel 10 installed.
## Installation
1. **Clone the repository**:
```sh
git clone https://github.com/SLoharkar/Currency-Converter-PHP-Laravel-Framework.git
cd Currency-Converter-PHP-Laravel-Framework
```
2. **Install dependencies**:
- Ensure you have PHP 7.4 and Composer installed.
- Copy the project's `composer.json` file:
```sh
cp path/to/project/composer.json .
```
- Run the Composer update command:
```sh
composer update
```
3. **Environment Setup**:
- `.env` and update the necessary environment variables, including database credentials and other configurations.
4. **Run migrations**:
```sh
php artisan migrate
```
5. **Generate APP Key**:
```sh
php artisan key:generate
```
6. **Start the development server**:
```sh
php artisan serve
```
## Usage
- **Normal Users**:
- Access the dashboard and use the currency converter with the default data source.
- **Admin Users**:
- Manage data sources (Excel and database).
- Export currencies in Excel and database.
- Manage users (delete, update).
- Manage IPs (add, delete, update).
## Middleware
- **ShareUserData**:
- Checks if the users' table is empty and logs out the user if true.
- Shares authenticated user's role and username with all views.
- Redirects to the login page if no user is authenticated.
## Custom Requests
- Handle data validation and business logic separation using custom request classes.
## Global Environment Variables
- Use environment variables for configuration settings.
## Logging
- Utilize Laravel's logging capabilities for error tracking and debugging.
## Blade Template Engine
- Create dynamic and reusable views using Laravel's Blade template engine.
## Security
- **IP Restriction**: Restrict access based on IP for normal users.
- **Authentication**: Secure authentication with hashed passwords.
## Acknowledgements
- Laravel framework and its community
- Floatrates for currency conversion data