包简介

Reusable helper utilities for Laravel 12 and 13 applications.

README 文档

README

Paket Laravel 12/13 yang menyediakan komponen Blade untuk membangun tampilan admin: komponen UI, aset layout yang dapat dipublish, helper tabel, remote select, interaksi modal, dan utilitas PHP.

Apa yang Disediakan

Komponen Blade bernamespace seperti x-laravel-helper::button, x-laravel-helper::form.input, x-laravel-helper::modal, x-laravel-helper::table-filter, dan x-laravel-helper::table-index.
Aset layout, CSS, dan JavaScript yang dapat dipublish untuk tema UI default.
Utilitas untuk query index, pesan exception, opsi enum, dan preservasi state index.

Persyaratan

PHP ^8.2
Laravel ^12.0 atau ^13.0
Vite untuk aplikasi yang menggunakan layout atau mengimpor CSS yang dipublish dari resources/css/app.css
Alpine.js untuk komponen interaktif seperti modal, table filter, table index, remote select, dan cascade select
window.axios untuk fitur remote select dan AJAX dependent select

Package menginstal dependensi runtime berikut melalui Composer:

blade-ui-kit/blade-icons
mallardduck/blade-lucide-icons
afatmustafa/blade-hugeicons
php-flasher/flasher-laravel
php-flasher/flasher-noty-laravel
php-flasher/flasher-sweetalert-laravel

Instalasi

Install package melalui Composer:

composer require kominfogusit/laravel-helper

Laravel auto-discovers service provider secara otomatis.

Publish file konfigurasi:

php artisan vendor:publish --tag=laravel-helper-config

Publish layout, CSS, dan JavaScript default:

php artisan vendor:publish --tag=laravel-helper-core-ui

Install aset Flasher:

php artisan flasher:install

Import CSS yang dipublish di resources/css/app.css:

@import './vendor/laravel-helper/default.css';

default.css mengimpor stylesheet package untuk layout, badge, button, card, link, modal, spinner, table-filter, table-index, dan komponen form.

Install Alpine.js dan Axios:

npm install alpinejs axios

Aktifkan Alpine dan daftarkan Axios di resources/js/app.js:

import Alpine from 'alpinejs';
import axios from 'axios';

window.Alpine = Alpine;
window.axios = axios;
window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';

Alpine.start();

Catatan: window.axios wajib tersedia agar fitur AJAX pada x-laravel-helper::form.select (cascade select) berfungsi.

Tambahkan @stack('head-scripts') di <head> layout aplikasimu, tepat sebelum @vite():

@stack('head-scripts')
@vite(['resources/css/app.css', 'resources/js/app.js'])

Komponen dari package ini akan secara otomatis mendaftarkan script yang dibutuhkan ke stack ini (via @pushOnce) hanya saat komponen tersebut digunakan di halaman.

Layout default yang dipublish sudah menyertakan @stack('head-scripts') ini secara otomatis.

Penggunaan Cepat

Gunakan layout yang dipublish sebagai shell aplikasi admin:

@extends('layout.default')

@section('page_heading', 'Dashboard')
@section('page_subheading', 'Ringkasan aplikasi dan aktivitas terbaru.')

@section('content')
    <x-laravel-helper::card>
        <p>Konten halaman ditulis di sini.</p>
    </x-laravel-helper::card>
@endsection

Setelah publish, kustomisasi menu navigasi di resources/views/layout/sidebar.blade.php dan user menu di resources/views/layout/topbar.blade.php. Lihat Panduan Layout untuk detail lengkap.

Gunakan form input:

<x-laravel-helper::form.input
    name="name"
    label="Nama"
    placeholder="Masukkan nama"
    required
/>

Gunakan action button:

<x-laravel-helper::button type="submit" variant="primary">
    Simpan
</x-laravel-helper::button>

Gunakan table index:

<x-laravel-helper::table-index
    :data-list="$users"
    :data-columns="[
        ['key' => 'name', 'label' => 'Nama', 'sortable' => true, 'sortKey' => 'name'],
        ['key' => 'email', 'label' => 'Email'],
    ]"
/>

Komponen

Form

Komponen	Kegunaan	Dokumentasi
`x-laravel-helper::form.input`	Field input teks dengan label, hint, error, atribut Livewire, dan fallback aksesibilitas.	Form Input
`x-laravel-helper::form.checkbox`	Field checkbox dengan label, deskripsi, checked state, error, dan dukungan `old()`.	Form Checkbox
`x-laravel-helper::form.textarea`	Field textarea dengan label, hint, error, rows, dan atribut Livewire.	Form Textarea
`x-laravel-helper::form.select`	Field select dengan label, hint, error, placeholder, dan mode searchable.	Form Select

UI

Komponen	Kegunaan	Dokumentasi
`x-laravel-helper::button`	Tombol atau link aksi dengan variant, loading state, ikon, dan mode icon-only.	Button
`x-laravel-helper::link`	Anchor dengan variant, perilaku underline, ikon, dan disabled state.	Link
`x-laravel-helper::badge`	Label kecil dengan variant, tone, ukuran, ikon, dan indikator dot.	Badge
`x-laravel-helper::card`	Kontainer konten dengan header opsional, footer, variant status, dan wrapper tag.	Card
`x-laravel-helper::spinner`	Indikator loading untuk form, tombol, dan area loading inline.	Spinner

Dialog & Modal

Komponen	Kegunaan	Dokumentasi
`x-laravel-helper::modal`	Dialog berbasis Alpine dengan event open/close/toggle dan slots.	Modal

Table

Komponen	Kegunaan	Dokumentasi
`x-laravel-helper::table-filter`	Toolbar filter query-string dengan pencarian cepat, modal filter, dan dependent select.	Table Filter
`x-laravel-helper::table-index`	Tabel data dengan header sortable, formatting, row action, rows-per-page, dan paginasi.	Table Index

Utilitas

Package menyediakan utilitas consumer-facing berikut:

Indrahulu\LaravelHelper\Services\IndexQueryService
Indrahulu\LaravelHelper\Services\ExceptionService
Indrahulu\LaravelHelper\Concerns\HasEnumOptions
Indrahulu\LaravelHelper\Concerns\PreservesIndexState

Lihat Utilitas untuk contoh penggunaan lengkap.

Dokumentasi

Development

composer install
composer test

Rilis package mengikuti Git tag, dimulai dari v0.1.0 untuk rilis praproduksi pertama.

kominfogusit/laravel-helper 适用场景与选型建议

kominfogusit/laravel-helper 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 35 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 04 月 14 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「helper」「laravel」「laravel-package」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 kominfogusit/laravel-helper 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 kominfogusit/laravel-helper 我们能提供哪些服务？

定制开发 / 二次开发

基于 kominfogusit/laravel-helper 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 kominfogusit/laravel-helper 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

fewagency/carbonator 3

Datetime helpers for timezone handling

rakibhstu/number-to-bangla 81

A Laravel package for converting English numbers into Bangla digits, Bangla words, Bangla month names, and Bangla money format with an easy-to-use API.

diplodocker/comments-loader 0

Laravel table comments loader (part of Diplodocker project)

fsc/batch 18

Library with classes to help you do batch.

jiten14/jitone-ai 22

jitone-ai is a powerful FilamentPHP plugin that integrates AI-powered features directly into your Filament forms.

mitsuru793/array-helper-function 0

This adds functions about array. If you feel like there few php built-in functions about array, this will be useful.

kominfogusit/laravel-helper

包简介

关键字：