README

Steak Core - Thư viện Laravel Core cho phát triển nhanh và bảo mật, được thiết kế để tương thích hoàn toàn với Laravel 11, Laravel 12 và Laravel Octane.

🚀 Tính năng chính

🔧 Core Engines

ShortCode Engine: Hệ thống shortcode mạnh mẽ tương tự WordPress
View Manager: Quản lý view và template với cache thông minh
Cache Engine: Hệ thống cache đa lớp với auto-invalidation
DCrypt Engine: Mã hóa/giải mã dữ liệu an toàn
JSON Data Engine: Xử lý dữ liệu JSON hiệu quả

🎯 Magic Classes

Arr: Array wrapper với magic methods và helper functions
Str: String utilities với hỗ trợ tiếng Việt
Any: Universal data wrapper cho mọi kiểu dữ liệu

🗂️ File Management

Filemanager: Quản lý file và thư mục toàn diện
File Methods: Các phương thức xử lý file nâng cao
Zip Methods: Nén và giải nén file
File Converter: Chuyển đổi định dạng file

🌐 HTTP & API

HTTP Client: HTTP client với Promise support
CURL Wrapper: CURL utilities nâng cao
Base API: Framework cho API development
HTTP Promise: Promise-based HTTP requests

🎨 HTML & UI

HTML Builder: Tạo HTML elements programmatically
Form Builder: Form generation với validation
Menu Builder: Menu system linh hoạt
Input Types: Input components đa dạng

📊 Repository Pattern

Base Repository: Repository pattern implementation
CRUD Actions: CRUD operations tự động
Filter Actions: Advanced filtering và searching
Cache Tasks: Cache management cho repositories

🔐 Security & Validation

Validators: Validation system mở rộng
Default Methods: Security utilities
System Mail Alert: Email security alerts

🌍 Internationalization

Locale Management: Multi-language support
Language Files: Dynamic language loading

📋 Yêu cầu hệ thống

PHP: ^8.1
Laravel: ^11.0 | ^12.0
Laravel Octane: ^2.0 (tùy chọn)

🛠️ Cài đặt

1. Cài đặt qua Composer

composer require steak/core

2. Đăng ký Service Provider

Service Provider sẽ được tự động đăng ký thông qua Laravel's auto-discovery.

3. Publish Configuration và Migrations (tùy chọn)

# Publish config file
php artisan vendor:publish --provider="Steak\Core\Providers\SteakServiceProvider" --tag="steak-config"

# Publish migrations
php artisan vendor:publish --provider="Steak\Core\Providers\SteakServiceProvider" --tag="steak-migrations"

# Hoặc publish tất cả
php artisan vendor:publish --provider="Steak\Core\Providers\SteakServiceProvider"

4. Chạy Migrations

# Chạy migrations của thư viện
php artisan migrate

# Hoặc sử dụng command riêng
php artisan steak:publish-migrations
php artisan migrate

🚀 Sử dụng nhanh

ShortCode Engine

use Steak\Core\Engines\ShortCode;

// Đăng ký shortcode
ShortCode::addShortcode('hello', function($atts, $content, $tag) {
    return '<h2>Xin chào từ shortcode!</h2>';
});

// Sử dụng trong nội dung
$content = "Đây là nội dung. [hello] Và đây là nội dung sau.";
$result = ShortCode::do($content, false);

Magic Array

use Steak\Core\Magic\Arr;

$data = new Arr(['name' => 'John', 'age' => 30]);

// Magic methods
echo $data->name; // John
echo $data->get('age'); // 30
echo $data->has('email'); // false

// Array operations
$data->set('email', 'john@example.com');
$data->remove('age');

File Management

use Steak\Core\Files\Filemanager;

$fm = new Filemanager('/path/to/directory');

// File operations
$fm->saveHtml('index.html', '<h1>Hello World</h1>');
$content = $fm->getHtml('index.html');

// Directory operations
$files = $fm->getList();
$fm->copy('source.txt', 'destination.txt');

HTTP Client

use Steak\Core\Http\Client;

$client = new Client();

// GET request
$response = $client->get('https://api.example.com/users');

// POST request với data
$response = $client->post('https://api.example.com/users', [
    'name' => 'John Doe',
    'email' => 'john@example.com'
]);

Repository Pattern

use Steak\Core\Repositories\BaseRepository;

class UserRepository extends BaseRepository
{
    protected $model = User::class;
    
    public function findByEmail($email)
    {
        return $this->model::where('email', $email)->first();
    }
}

🔧 Laravel Octane Support

Steak Core được thiết kế để tương thích hoàn toàn với Laravel Octane:

Tự động State Management

use Steak\Core\Contracts\OctaneCompatible;

class MyService implements OctaneCompatible
{
    private static $cache = [];
    
    public static function resetStaticState(): void
    {
        self::$cache = [];
    }
    
    public function resetInstanceState(): void
    {
        // Reset instance state
    }
    
    public static function getStaticProperties(): array
    {
        return ['cache'];
    }
}

Octane Events

WorkerStarting: Khởi tạo worker
RequestReceived: Xử lý request mới
RequestTerminated: Reset state sau request

📚 API Documentation

ShortCode API

Method	Description
`ShortCode::addShortcode($tag, $callback)`	Đăng ký shortcode mới
`ShortCode::do($content, $ignore_html)`	Xử lý nội dung có shortcode
`ShortCode::hasShortcode($content, $tag)`	Kiểm tra shortcode có tồn tại
`ShortCode::removeShortcode($tag)`	Xóa shortcode

Arr API

Method	Description
`$arr->get($key, $default)`	Lấy giá trị theo key
`$arr->set($key, $value)`	Gán giá trị
`$arr->has($key)`	Kiểm tra key có tồn tại
`$arr->remove($key)`	Xóa key
`$arr->merge($array)`	Merge với array khác

Filemanager API

Method	Description
`$fm->saveHtml($filename, $content)`	Lưu file HTML
`$fm->getHtml($filename)`	Đọc file HTML
`$fm->copy($src, $dst)`	Copy file/thư mục
`$fm->move($src, $dst)`	Di chuyển file/thư mục
`$fm->delete($path)`	Xóa file/thư mục

🧪 Testing

Chạy tests

composer test

Octane Compatibility Tests

php artisan test --filter=OctaneCompatibilityTest

🔒 Security

Tất cả input được sanitize tự động
SQL injection protection
XSS protection
CSRF protection
Secure file operations

🌍 Internationalization

use Steak\Core\Languages\Locale;

// Set language
Locale::setLang('vi');

// Get translation
$message = Locale::get('welcome.message');

📦 Package Structure

src/
├── core/
│   ├── Concerns/          # Traits và shared functionality
│   ├── Contracts/         # Interfaces và contracts
│   ├── Core/             # Core system classes
│   ├── Crawlers/         # Web crawling utilities
│   ├── Engines/          # Core engines (ShortCode, Cache, etc.)
│   ├── Files/            # File management system
│   ├── Html/             # HTML builders và components
│   ├── Http/             # HTTP client và utilities
│   ├── Languages/        # Internationalization
│   ├── Magic/            # Magic classes (Arr, Str, Any)
│   ├── Mailer/           # Email system
│   ├── Masks/            # Data masking và transformation
│   ├── Models/           # Base models
│   ├── Providers/        # Service providers
│   ├── Repositories/     # Repository pattern implementation
│   ├── Services/         # Service classes
│   ├── System/           # System utilities
│   ├── Validators/       # Validation system
│   └── Web/              # Web utilities
├── helpers/              # Helper functions
└── app/                  # Application specific code

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Documentation: https://steak.dev/docs
Issues: GitHub Issues
Discussions: GitHub Discussions
Email: support@steak.dev

🏆 Credits

Developed with ❤️ by the Steak Team

Steak Core - Empowering Laravel development with powerful tools and utilities.

steak / core

Maintainers

Details

README

🚀 Tính năng chính

🔧 Core Engines

🎯 Magic Classes

🗂️ File Management

🌐 HTTP & API

🎨 HTML & UI

📊 Repository Pattern

🔐 Security & Validation

🌍 Internationalization

📋 Yêu cầu hệ thống

🛠️ Cài đặt

1. Cài đặt qua Composer

2. Đăng ký Service Provider

3. Publish Configuration và Migrations (tùy chọn)

4. Chạy Migrations

🚀 Sử dụng nhanh

ShortCode Engine

Magic Array

File Management

HTTP Client

Repository Pattern

🔧 Laravel Octane Support

Tự động State Management

Octane Events

📚 API Documentation

ShortCode API

Arr API

Filemanager API

🧪 Testing

Chạy tests

Octane Compatibility Tests

🔒 Security

🌍 Internationalization

📦 Package Structure

🤝 Contributing

📄 License

🆘 Support

🏆 Credits