包简介

Jaxon library integration for the Laravel framework

README 文档

README

This package is an extension to integrate the Jaxon library into the Laravel framework. It works with Laravel version 7 or newer.

Installation

Add the following lines in the composer.json file, and run the composer update jaxon-php/* command.

"require": {
    "jaxon-php/jaxon-laravel": "^5.0"
}

Publish the package configuration.

php artisan vendor:publish --tag=config

Configuration

The library configuration is located in the config/jaxon.php file. It must contain both the app and lib sections defined in the documentation (https://www.jaxon-php.org/docs/v5x/about/configuration.html).

An example is presented in the config/config.php file of this repo.

Routing and middlewares

The extension automatically registers two middlewares, jaxon.config and, jaxon.ajax.

The jaxon.config middleware calls the Jaxon library setup function. It must be added to the routes to pages that need to show Jaxon related content.

Route::get('/', [DemoController::class, 'index'])
    ->middleware(['web', 'jaxon.config'])
    ->name('demo');

The extension also registers the Jaxon requests route and the associated middlewares.

The route url is the value of the lib.core.request.uri option, the app.request.route gives an optional name to the route, and the app.request.middlewares option defines additional middlewares.

    'app' => [
        'request' => [
            'route' => 'jaxon', // The route name
            'middlewares' => ['web'],
        ],
    ],
    'lib' => [
        'core' => [
            'request' => [
                'uri' => '/jaxon', // The route url
            ],
        ],
    ],

Usage

This extension registers the following Blade directives to insert Jaxon js and css codes in the pages that need to show Jaxon related content.

// resources/views/demo/index.blade.php

<!-- In page header -->
@jxnCss()
</head>

<body>
<!-- Page content here -->
</body>

<!-- In page footer -->
@jxnJs()

@jxnScript()

Call factories

This extension registers the following Blade directives for Jaxon call factories functions.

Note

In the following examples, the $rqAppTest template variable is set to the value rq(Demo\Ajax\App\AppTest::class).

The jxnBind directive attaches a UI component to a DOM element, while the jxnHtml directive displays a component HTML code in a view.

    <div class="col-md-12" @jxnBind($rqAppTest)>
        @jxnHtml($rqAppTest)
    </div>

The jxnPagination directive displays pagination links in a view.

    <div class="col-md-12" @jxnPagination($rqAppTest)>
    </div>

The jxnOn directive binds an event on a DOM element to a Javascript call defined with a call factory.

    <select class="form-select"
        @jxnOn('change', $rqAppTest->setColor(jq()->val()))>
        <option value="black" selected="selected">Black</option>
        <option value="red">Red</option>
        <option value="green">Green</option>
        <option value="blue">Blue</option>
    </select>

The jxnClick directive is a shortcut to define a handler for the click event.

    <button type="button" class="btn btn-primary"
        @jxnClick($rqAppTest->sayHello(true))>Click me</button>

The jxnEvent directive defines a set of events handlers on the children of a DOM element, using jQuery selectors.

    <div class="row" @jxnEvent([
        ['.app-color-choice', 'change', $rqAppTest->setColor(jq()->val())]
        ['.ext-color-choice', 'change', $rqExtTest->setColor(jq()->val())]
    ])>
        <div class="col-md-12">
            <select class="form-control app-color-choice">
                <option value="black" selected="selected">Black</option>
                <option value="red">Red</option>
                <option value="green">Green</option>
                <option value="blue">Blue</option>
            </select>
        </div>
        <div class="col-md-12">
            <select class="form-control ext-color-choice">
                <option value="black" selected="selected">Black</option>
                <option value="red">Red</option>
                <option value="green">Green</option>
                <option value="blue">Blue</option>
            </select>
        </div>
    </div>

The jxnEvent directive takes as parameter an array in which each entry is an array with a jQuery selector, an event and a call factory.

Contribute

Issue Tracker: github.com/jaxon-php/jaxon-laravel/issues
Source Code: github.com/jaxon-php/jaxon-laravel

License

The package is licensed under the BSD license.

jaxon-php/jaxon-laravel 适用场景与选型建议

jaxon-php/jaxon-laravel 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 1.77k 次下载、GitHub Stars 达 10，最近一次更新时间为 2016 年 06 月 15 日，在 PHP 生态内属于活跃度较高的组件。

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

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

围绕 jaxon-php/jaxon-laravel 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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