566E
首页 包列表 提交包 常见问题 关于

plinker/nginx 问题修复 & 功能扩展

解决BUG、新增功能、兼容多环境部署，快速响应你的开发需求

邮箱：yvsm@zunyunkeji.com | QQ：316430983 | 微信：yvsm316

plinker/nginx

Composer 安装命令：

composer require plinker/nginx

包简介

Control Nginx as a reverse proxy through plinker RPC

关键字：

#rpc #nginx #plinker

README 文档

README

The aim of this component is to build web forwards/reverse proxy to LXD/LXC containers on the host (or external upstreams), not as a server{} block configurator.

The component uses nginx as a reverse proxy, it relies on php7-fpm being installed and will overwrite /etc/nginx/nginx.conf! So if you already have nginx installed then dont use this component as it will most likely break your stuff.

Install

Require this package with composer using the following command:

$ composer require plinker/nginx

Then navigate to ./vendor/plinker/nginx/scripts and run bash install.sh.

Client

Creating a client instance is done as follows:

<?php
require 'vendor/autoload.php';

/**
 * Initialize plinker client.
 *
 * @param string $server - URL to server listener.
 * @param string $config - server secret, and/or a additional component data
 */
$client = new \Plinker\Core\Client(
    'http://example.com/server.php',
    [
        'secret' => 'a secret password',
        // database connection
        'database' => [
            'dsn'      => 'sqlite:./.plinker/database.db',
            'host'     => '',
            'name'     => '',
            'username' => '',
            'password' => '',
            'freeze'   => false,
            'debug'    => false,
        ]
    ]
);

// or using global function
$client = plinker_client('http://example.com/server.php', 'a secret password', [
    // database connection
    'database' => [
        'dsn'      => 'sqlite:./.plinker/database.db',
        'host'     => '',
        'name'     => '',
        'username' => '',
        'password' => '',
        'freeze'   => false,
        'debug'    => false,
    ]
]);

Methods

Once setup, you call the class though its namespace to its method.

Setup

Applies build tasks to plinker/tasks queue.

Parameter Type Description Default
options array Build options

Call

$client->nginx->setup([
    'build_sleep' => 5,
    'reconcile_sleep' => 5,
]);

Response

Update Package

Runs composer update to update package.

Call

$client->nginx->update_package();

Response

Add

Add a web proxy rule.

Parameter Type Description Default
data array Rule data

Call

$client->nginx->addBlock([
    'label' => 'My website nginx route',
    'ownDomain' => [
        'example.com',
        'www.example.com'
    ],
    'ownUpstream' => [
        ['ip' => '10.158.250.5', 'port' => '80']
    ],
    'letsencrypt' => 1,
    'enabled' => 1
]);

Response

Array
(
    [status] => success
    [values] => Array
        (
            [id] => 1
            [label] => My website nginx route
            [name] => c094c6c1-0fa1-40f1-af66-60e173e8dbac
            [ssl_type] => letsencrypt
            [added] => 2018-05-13 17:25:51
            [updated] => 2018-05-13 17:25:51
            [has_change] => 1
            [has_error] => 0
            [delete] => 0
            [enabled] => 1
            [update_ip] => 0
            [ip] => 10.158.250.5
            [port] => 80
            [ownDomain] => Array
                (
                    [0] => Array
                        (
                            [id] => 1
                            [name] => example.com
                            [route_id] => 1
                        )

                    [1] => Array
                        (
                            [id] => 2
                            [name] => www.example.com
                            [route_id] => 1
                        )

                )

            [ownUpstream] => Array
                (
                    [0] => Array
                        (
                            [id] => 1
                            [ip] => 10.158.250.5
                            [port] => 80
                            [route_id] => 1
                        )

                )

        )

)

Update Block

Update a web proxy rule.

Parameter Type Description Default
placeholder string Query placeholder
values array Match values
data array Updated rule data

Call

client->nginx->update('name = ?', ['b2f78de7-5994-4c21-9c55-76cefe327a67'], [
    'label' => $test_route_label,
    'ownDomain' => [
        'updated-example.com',
        'www.updated-example.com'
    ],
    'ownUpstream' => [
        ['ip' => '10.158.250.5', 'port' => '80']
    ],
    'letsencrypt' => 0,
    'enabled' => 1
]);

Response


Array
(
    [status] => success
    [values] => Array
        (
            [id] => 3
            [label] => Example
            [name] => b2f78de7-5994-4c21-9c55-76cefe327a67
            [ssl_type] => 
            [added] => 2018-05-12 20:17:09
            [updated] => 2018-05-13 17:28:50
            [has_change] => 1
            [has_error] => 1
            [delete] => 0
            [enabled] => 1
            [update_ip] => 0
            [ip] => 10.158.250.5
            [port] => 80
            [error] => {}
            [ownDomain] => Array
                (
                    [0] => Array
                        (
                            [id] => 9
                            [name] => updated-example.com
                            [route_id] => 3
                        )

                    [1] => Array
                        (
                            [id] => 10
                            [name] => www.updated-example.com
                            [route_id] => 3
                        )

                )

            [ownUpstream] => Array
                (
                    [0] => Array
                        (
                            [id] => 5
                            [ip] => 10.158.250.5
                            [port] => 80
                            [route_id] => 3
                        )

                )

        )

)

Remove

Remove web proxy rule.

Parameter Type Description Default
placeholder string Query placeholder
values array Match values

Call

ruleById(1)   - $client->nginx->remove('id = ?', [1]);
ruleByName(1) - $client->nginx->remove('name = ?', ['guidV4-value'])

Response

Array
(
    [status] => success
)

Reset

Remove all web proxy rules.

Parameter Type Description Default
purge bool Also remove tasks false

Call

$client->nginx->reset();     // remove just rules
$client->nginx->reset(true); // remove rules and tasks (purge)

Response

Array
(
    [status] => success
)

Fetch

Fetch currently configured web proxy rules from database.

Parameter Type Description Default
placeholder string Query placeholder
values array Match values

Call

all           - $client->nginx->fetch();
ruleById(1)   - $client->nginx->fetch('id = ?', [1]);
ruleByName(1) - $client->nginx->fetch('name = ?', ['guidV4-value'])

Response

Array
(
    [0] => Array
        (
            [id] => 1
            [label] => Example
            [name] => 9801e216-a663-4f21-a3f5-047be2b3b9c9
            [ssl_type] => 
            [added] => 2018-05-12 19:52:58
            [updated] => 2018-05-12 19:52:58
            [has_change] => 0
            [has_error] => 0
            [delete] => 0
            [enabled] => 1
            [update_ip] => 0
            [ip] => 10.158.250.5
            [port] => 80
            [error] => 
            [ownDomain] => Array
                (
                    [0] => Array
                        (
                            [id] => 1
                            [name] => example.com
                            [route_id] => 2
                        )

                    [1] => Array
                        (
                            [id] => 2
                            [name] => www.example.com
                            [route_id] => 2
                        )

                )

            [ownUpstream] => Array
                (
                    [0] => Array
                        (
                            [id] => 1
                            [ip] => 10.158.250.5
                            [port] => 80
                            [route_id] => 2
                        )

                )

        )
)

Count

Fetch count of currently configured web proxy rules from database.

Parameter Type Description Default
placeholder string Query placeholder
values array Match values

Call

all           - $client->nginx->count();
ruleById(1)   - $client->nginx->count('id = ?', [1]);
ruleByName(1) - $client->nginx->count('name = ?', ['guidV4-value'])

Response

1

Rebuild

Rebuild web proxy rule.

Parameter Type Description Default
placeholder string Query placeholder
values array Match values

Call

ruleById(1)   - $client->nginx->rebuild('id = ?', [1]);
ruleByName(1) - $client->nginx->rebuild('name = ?', ['guidV4-value'])

Response

Array
(
    [status] => success
)

Status

Enumarate and return status of nginx connections.

Call

$client->nginx->status();

Response

Array
(
    [active_connections] => 2
    [accepts] => 579
    [handled] => 579
    [requests] => 579
    [reading] => 0
    [writing] => 2
    [waiting] => 0
)

Testing

There are no tests setup for this component.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please contact me via https://cherone.co.uk instead of using the issue tracker.

Credits

Development Encouragement

If you use this project and make money from it or want to show your appreciation, please feel free to make a donation https://www.paypal.me/lcherone, thanks.

Sponsors

Get your company or name listed throughout the documentation and on each github repository, contact me at https://cherone.co.uk for further details.

License

The MIT License (MIT). Please see License File for more information.

See the organisations page for additional components.

plinker/nginx 适用场景与选型建议

plinker/nginx 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 400 次下载、GitHub Stars 达 0， 最近一次更新时间为 2017 年 09 月 22 日， 在 PHP 生态内属于活跃度较高的组件。

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

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

围绕 plinker/nginx 我们能提供哪些服务？
定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

与 plinker/nginx 相关的其它包

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

bitninja/ninjarpc 0

Microservice RPC through message queues.

andrey-tech/nginx-unit-log-analyzer-php 0

Tool to analyze NGINX Unit log file in console

plinker/core 1

PlinkerRPC PHP client/server makes it really easy to link and execute PHP component classes on remote systems, while maintaining the feel of a local method call.

sinnbeck/laravel-served 74

Dockerized version of artisan serve

systemsdk/docker-nginx-php-laravel 345

Docker laravel environment

plinker/iptables 1

WIP: Control iptables through plinker RPC

统计信息

  • 总下载量： 400
  • 月度下载量： 0
  • 日度下载量： 0
  • 收藏数： 0
  • 点击次数： 2
  • 依赖项目数： 1
  • 推荐数： 0

GitHub 信息

  • Stars： 0
  • Watchers： 1
  • Forks： 0
  • 开发语言： PHP
访问仓库

其他信息

  • 授权协议： MIT
  • 更新时间： 2017-09-22