https://github.com/vitexsoftware/flexiproxy
Transparentní Proxy pro filtraci i modifikaci komunikace s FlexiBee
https://github.com/vitexsoftware/flexiproxy
easephp flexibee php proxy
Last synced: about 2 months ago
JSON representation
Transparentní Proxy pro filtraci i modifikaci komunikace s FlexiBee
- Host: GitHub
- URL: https://github.com/vitexsoftware/flexiproxy
- Owner: VitexSoftware
- Created: 2017-03-31T08:51:05.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-09-03T21:28:58.000Z (over 3 years ago)
- Last Synced: 2025-02-14T22:38:22.168Z (4 months ago)
- Topics: easephp, flexibee, php, proxy
- Language: PHP
- Size: 2.17 MB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
FlexiProxy
=======================================
* author Vítězslav Dvořák
* copyright 2017 VitexSoftware (c)
Co aplikace umí
---------------
* Proxy mezi AbraFlexi a klientem
* Měnit Logo
* Přidává práci s obrázky v ceníku
* Přidává položky do menu
* Rozšíření pro vývojáře
Co aplikace neumí
-----------------
* Uvidíme
Instalace
---------
### Debian
Pro Debian či Ubuntu prosím použijte [repozitář](http://vitexsoftware.cz/repos.php) se závislostmi composer, EaseFramework a FlexiPeehp:
wget -O - http://v.s.cz/[email protected]|sudo apt-key add -
echo deb http://v.s.cz/ stable main > /etc/apt/sources.list.d/vitexsoftware.list
apt update
apt install flexiproxy
během instalace bude proveden dotaz na přihlašovací údaje do AbraFlexi a umístění složky se vstupními soubory
### Git
Pro jiné systémy je třeba
git clone https://github.com/VitexSoftware/FlexiProxy.git
cd FlexyProxy
composer install
a poté upravit __config.json__
Spouštění
---------
Spouštění se provádí skriptem src/doit.php nebo příkazem /usr/bin/flexiproxy z debianího balíčku
Konfigurace
-----------
Ten si načte obsah konfiguračního souboru config.json
{
"EASE_APPNAM": "FlexiProxy",
"EASE_LOGGER": "syslog|console",
"EMAIL_FROM": "flexiproxy@localhost",
"FLEXIBEE_URL": "https://localhost:5434",
"FLEXIBEE_LOGIN": "admin",
"FLEXIBEE_PASSWORD": "admin123",
"FLEXIBEE_COMPANY": "spoje_net_s_r_o_4",
"access_policy": "login",
"debug": "true",
"logo": "/images/yourlogo.png"
}
* access_policy: **public** - zpřístupní vše pod uživatelem z natavení; **login** - je nutné se přihlásit
* debug: vypisuje dodatečné ladící ingormace (nepovinné)
* logo: jiný než výchozí obrázek pro modul logochanger (nepovinné)
Uživatelské položky v menu
--------------------------
Pokud potřebujeme do menu přidat nějaké další položky je zde k dispozici modul
[[src/FlexiProxy/plugins/output/html/CustomMenu.php]](output/html/CustomMenu.php)
(istaluje se jako balíček flexiproxy-custom-menu) a konfiguruje se pomocí JSON
konfiguráku v konfigurační složce.
Obsahuje povinně alespoň jednu sekci "left-menu" nebo "right-menu" určující na
kterou stranu menu se mají její podpoložky přidat.
Podpoložky mohou být buď odkaz nebo další podmenu jak je vidět v ukázkovém
konfiguráku:
```json
{
"left-menu": {
"http://v.s.cz/": "Autor",
"Left Menu 1": {
"a": "b",
"0": "",
"c": "d"
},
"Left menu 2": {
"e": "f",
"0": "",
"g": "h"
}
},
"right-menu": {
"Right Menu 1": {
"k": "l",
"0": "",
"m": "n"
},
"Right menu 2": {
"o": "p",
"0": "",
"q": "r"
}
}
}
```
Prázdná položka **"0": ""** je rendrována jako oddělovač.
Logování
--------
Se provádí do systémového logu. Ten pak vypadá zhruba takto:
Nov 7 17:41:44 dellnik FlexiProxy: `AbraFlexi\Adresar` ❁ GET AddressBook item AT Computers a.s. as https://localhost:5434/c/firma_s_r_o_/adresar/641.json
Testování
---------
Skript obsahuje i PHPUnit testy
Vagrant
-------
pro vyzkoušení aplikace je třeba zadat tyto příkazy
sudo sed -i '/^127.0.0.1/ s/$/ flexiproxy.vagrant/' /etc/hosts
sudo a2enmod proxy
sudo ln -s `realpath testing/localapache.conf` /etc/apache2/sites-available/
sudo a2ensite localapache
sudo service apache2 restart
vagrant up
Aplikace pak bude dostupná na adrese http://flexiproxy.vagrant/
Databaze
--------
vendor/bin/phinx create CustomColumns -c phinx-adapter.php
vendor/bin/phinx migrate -c phinx-adapter.php
Testing
-------
At first you need initialise create sql user & database with login and password
from testing/phinx.yml and initialise testing database by **phinx migrate**
command:
```
composer update
cd tests
mysqladmin -u root -p create flexiproxy
mysql -u root -p -e "GRANT ALL PRIVILEGES ON flexiproxy.* TO flexiproxy@localhost IDENTIFIED BY 'flexiproxy'"
sudo -u postgres bash -c "psql -c \"CREATE USER flexiproxy WITH PASSWORD 'flexiproxy';\""
sudo -u postgres bash -c "psql -c \"create database flexiproxy with owner flexiproxy encoding='utf8' template template0;\""
../vendor/bin/phinx migrate -e development
../vendor/bin/phinx migrate -e testing
```
Building
--------
Simply run debian/deb-package.sh
For Docker:
docker build -t vitexus/flexiproxy .
docker push vitexus/flexiproxy
Links
=====
Homepage: https://www.vitexsoftware.cz/flexiproxy.php
GitHub: https://github.com/VitexSoftware/FlexiProxy
Demo: http://flexiproxy.vitexsoftware.cz/c/demo