Download the PHP package turahe/core without Composer
On this page you can find all versions of the php package turahe/core. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package core
Short Description A comprehensive Laravel package providing core functionality for modern web applications, including image processing, OAuth integration, taxonomy management, organization handling, and utility helpers.
License MIT
Informations about the package core
Turahe Core
A comprehensive Laravel package providing core functionality for modern web applications including image processing, OAuth integration, taxonomy management, organization handling, and utility helpers.
๐ Features
๐ธ Image Processing
- ImgProxy Integration: Secure image URL signing and processing
- Image Optimization: Automatic resizing, cropping, and format conversion
- Preset Support: Predefined image processing configurations
- Signature Verification: Secure image URL validation
๐ OAuth Integration
- Google OAuth: Complete Google API integration with Calendar, Gmail, and Drive
- Microsoft Graph: Full Microsoft Graph API support for Office 365 services
- Token Management: Automatic token refresh and storage
- Resource Owners: Custom resource owner implementations
๐ท๏ธ Taxonomy & Tagging
- Hierarchical Taxonomies: Nested set implementation for complex categorization
- Flexible Tagging: Polymorphic tagging system for any model
- Slug Generation: Automatic slug creation with Spatie Laravel Sluggable
- Sortable Content: Drag-and-drop ordering with Spatie Eloquent Sortable
๐ข Organization Management
- Multi-tenant Support: Organization-based data isolation
- Role-based Access: Member, Admin, and Owner roles
- Hierarchical Structure: Nested organization trees
- User Associations: Flexible user-organization relationships
๐ง Email Services
- Gmail Integration: Full Gmail API support with message handling
- Microsoft Graph Email: Outlook/Exchange email integration
- Attachment Processing: Automatic email attachment handling
- Message Composition: Rich email composition features
๐ ๏ธ Utility Helpers
- Currency Formatting:
format_currency()for consistent money display - Name Aliases:
name_alias()for user-friendly name display - Text Cleaning:
clean()for sanitized text output - Acronym Generation:
acronym()for abbreviation creation - Image URLs:
imgProxy()andimgProxyPreset()for secure image URLs - Percentage Calculations:
calculate_percentage()for mathematical operations - Phone Parsing:
parse_phone()for international phone number handling
๐ฆ Installation
Requirements
- PHP 8.4 or higher
- Laravel 12
- SQLite (for testing)
- Redis (optional, for production caching)
Via Composer
Publish Configuration
Run Migrations
๐ Documentation
For comprehensive documentation, guides, and technical details, visit the docs/ directory:
- ๐ Documentation Index - Complete documentation overview
- ๐งช Testing Guide - Testing setup and guidelines
- ๐ง Scripts & Tools - Utility scripts and automation
โ๏ธ Configuration
Environment Variables
Google OAuth Setup
Microsoft Graph Setup
ImgProxy Configuration
๐ง Usage
Service Providers
The package automatically registers the CoreServiceProvider. You can also manually register it in config/app.php:
Facades
The package provides convenient facades for Google and Microsoft services:
Helper Functions
Models and Traits
HasOrganization Trait
HasSettings Trait
HasTaxonomies Trait
HasTags Trait
Repositories
๐งช Testing
Running Tests
Local Testing
Test Coverage
- Unit Tests: 196 tests with 418 assertions
- Feature Tests: 250 tests with 799 assertions
- Total Tests: 446 tests with 1,217 assertions
- Coverage: Comprehensive coverage of all package features
- Database: SQLite in-memory for fast, isolated testing
๐งช Testing & Quality
Current Status โ
- All 446 tests passing with comprehensive coverage
- SQLite in-memory database for fast, isolated testing
- No environment variables needed - all configuration is hardcoded
- Xdebug coverage working correctly
- GitHub Actions CI fully functional with SQLite-only setup
- UserStamps integration working with ULID primary keys
- Eloquent relationships properly tested and validated
- Code formatting follows Laravel Pint standards
Test Suites
- Unit Tests: Core functionality, models, repositories, services
- Feature Tests: Database integration, traits, migrations
- Migration Tests: All database schema variations (ULID, UUID, BigIncrements)
- Repository Tests: CRUD operations and custom methods
- Trait Tests: HasOrganization, HasSettings, HasTags, HasTaxonomies
Code Quality
- Laravel Pint: Automatic code formatting with Laravel preset
- Consistent Style: All code follows Laravel coding standards
- PHPDoc: Comprehensive documentation with proper formatting
- Clean Code: Proper spacing, line endings, and structure
๐งช Local Development
Quick Start
Testing Environment
- PHP 8.4+: Required for development
- SQLite: In-memory database for testing (no file setup needed)
- Array Cache: In-memory cache driver for testing
- Xdebug: Required for coverage reports
- Composer: Dependency management
- No .env file needed: All configuration is hardcoded in TestCase.php
Development Tools
- Laravel Pint: Code formatting and style enforcement
- Coverage Scripts: Automated test coverage generation
- Git Hooks: Pre-commit formatting checks (optional)
- IDE Support: Full IDE integration with proper formatting
๐ CI/CD
The package includes streamlined GitHub Actions workflows focused on testing:
- CI Tests: PHP 8.4 + Laravel 12 testing with SQLite in-memory
- Coverage: Xdebug coverage reports uploaded to Codecov
- Dependabot: Automated dependency updates with testing
- Releases: Test validation before release
๐ค Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Development Setup
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
๐จโ๐ป Author
Nur Wachid - [email protected]
๐ Acknowledgments
- Laravel - The web framework
- Spatie - Laravel packages
- Google APIs - Google services
- Microsoft Graph - Microsoft services
- ImgProxy - Image processing
- Orchestra Testbench - Package testing
Made with โค๏ธ for the Laravel community
All versions of core with dependencies
ext-iconv Version *
ext-intl Version *
google/apiclient Version ^2.18
kalnoy/nestedset Version ^6.0
league/fractal Version ^0.20.1
league/oauth2-google Version ^4.0
microsoft/microsoft-graph Version ^1.94
propaganistas/laravel-phone Version ^5.3
spatie/eloquent-sortable Version ^4.4
spatie/laravel-sluggable Version ^3.6
turahe/laravel-userstamps Version ^1.0
turahe/master-data Version ^1.0
laravel/framework Version ^12.0