spojenet/subreg

PHP Based Library for easy interaction with soap.subreg.cz

1.2.1 2025-01-10 11:21 UTC

Requires

• ext-soap: *
• vitexsoftware/ease-core: >=1.41

Requires (Dev)

• ergebnis/composer-normalize: ^2.43
• ergebnis/php-cs-fixer-config: ^6.34
• friendsofphp/php-cs-fixer: ^3.61
• phpstan/phpstan: *
• phpstan/phpstan-phpunit: 2.0.x-dev
• phpunit/phpunit: *

MIT

• Vítězslav Dvořák

README

CZ: PHP Knihovna pro snadnou práci s API Subreg.cz

Poděkování

Vznik této knihovny by nebyl možný bez laskavé podpory společnosti Spoje.Net, která hradila vývoj řešení pro navýšení kreditu registrace domén služby. 👍

U společnosti Spoje.Net, je možné si objednat komerční podporu pro integraci knihovny do vašich projektů.

Instalace

composer require spojenet/subreg

Konfigurace

Konfigurace se provádí nastavením následujících konstant:

EASE_LOGGER=syslog|console
SUBREG_LOCATION=https://soap.subreg.cz/cmd.php
SUBREG_URI=https://soap.subreg.cz/soap
SUBREG_LOGIN=spojenetapi#spoje.net
SUBREG_PASSWORD=KfbBPb?Uk6Q@%uca

nebo je možné přihlašovací údaje zadávat při vytváření instance třídy.

    $sr = new \Subreg\Client([
        "location": "https://ote-soap.subreg.cz/cmd.php",
        "uri": "https://ote-soap.subreg.cz/soap",
        "login": "php-subreg",
        "password": "661a2725fb"
            ]);

Tento způsob nastavení má vyšší prioritu než výše uvedené definovaní konstant.

Jak to celé funguje ?

Ústřední komponentou celé knihovny je Třída Client, která je schopna pomocí PHP rozšíření SoapClient komunikovat se soap.subreg.cz.

http://demoreg.net/en/settings/settings

Debian/Ubuntu

Pro Linux jsou k dispozici .deb balíčky. Prosím použijte repo:

sudo apt install lsb-release wget apt-transport-https bzip2

wget -qO- https://repo.vitexsoftware.com/keyring.gpg | sudo tee /etc/apt/trusted.gpg.d/vitexsoftware.gpg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/vitexsoftware.gpg]  https://repo.vitexsoftware.com  $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install php-spojenet-subreg

V tomto případě je potřeba do souboru composer.json vaší aplikace přidat:

    "require": {
        "php-subreg": "*",
        "ease-core": "*"
    },
    "repositories": [
        {
            "type": "path",
            "url": "/usr/share/php/Subreg",
            "options": {
                "symlink": true
            }
        },
        {
            "type": "path",
            "url": "/usr/share/php/EaseCore",
            "options": {
                "symlink": true
            }
        }
    ]

Takže při instalaci závislostí bude vypadat nějak takto:

Loading composer repositories with package information
Installing dependencies from lock file
  - Installing ease-core (1.1.3.3)
    Symlinked from /usr/share/php/Ease

  - Installing php-subreg (0.2.1)
    Symlinked from /usr/share/php/Subreg

A aktualizaci bude možné dělat globálně pro celý systém prostřednictvím apt-get.