ulogger server

這是用於實時收集地理位置數據的Web應用程序，跟踪查看和管理。連同專用的μlogger移動客戶端，可以用作完整的自託管服務器解決方案，用於記錄和監視用戶的地理位置。

現場演示：

• https://ulogger.lima.zone
• 用於使用Android應用程序測試軌道上傳或用用戶軌跡編輯登錄：演示，密碼：演示
• 由lima-city.de主持

最低要求：

• PHP 5.5
• PHP擴展：CTYPE，JSON，PDO（與各自的驅動程序），會話，SimplexML，XMLWriter，Xdebug（僅用於測試）
• mysql，postgresql或sqlite（PDO驅動程序）
• 啟用JavaScript的瀏覽器，用於身份驗證的cookie和保存首選項

特徵：

• 簡單的
• 允許實時跟踪
• 軌道統計
• 高度圖
• 多個用戶
• 用戶身份驗證
• Google地圖
• 露天層（OpenStreet和其他層）
• 用戶首選項存儲在cookie中
• 簡單的管理菜單
• 向GPX和KML出口軌道
• 從GPX進口軌道

安裝

• 下載Zipped存檔或克隆計算機上的存儲庫
• 將其移動到您的Web服務器目錄（如果需要的話）
• 修復文件夾權限： uploads文件夾（用於上傳的圖像）應由PHP腳本編寫
• 對於開發版本，有必要從源文件構建JavaScript捆綁包。您將需要安裝npm並運行npm install並且在根文件夾中npm run build
• 創建數據庫和數據庫用戶（至少選擇，插入，更新，刪除特權，創建，刪除設置腳本，PostgreSQL的序列）
• 創建config.default.php的副本，然後將其重命名為config.php 。自定義並添加數據庫憑據
• 編輯scripts/setup.php腳本，通過將$啟用值設置為true來啟用它
• 確保您的Web服務器運行具有PHP和選擇的數據庫
• 打開http：//your_host/ulogger-server/scripts/setup.php頁面中的瀏覽器中
• 按照設置腳本中的說明進行操作。它將添加數據庫表並設置您的μlogger用戶
• 請記住刪除或禁用scripts/setup.php腳本
• 在http：// your_host/ulogger-server/
• 您可能還需要將新用戶設置為配置文件中的管理員
• 文件夾.docker/ and .tests/以及作曲家文件僅用於開發。可以安全地刪除

升級到版本1.x

• 不兼容的更改包括數據庫和配置文件更改
• 手動升級：
  • 有關數據庫更改，請參見scripts/migrate_to_1_x.mysql中的MySQL示例腳本
  • 將users表中的admin列設置為true的管理用戶
  • 從應用程序設置對話框中編輯配置
• 從0.6版中使用遷移腳本升級：
  • 創建數據庫備份
  • 用新的文件替換所有項目文件，但請保留舊的本地配置文件： config.php
  • 將目錄更改為應用程序根文件夾，並從控制台運行遷移腳本： php scripts/migrate_to_1_x.php
  • 該腳本將更新數據庫架構，並將舊的配置變量保存到數據庫
• 手冊或腳本更新後的其他任務：
  • 編輯您的config.php文件，然後刪除除數據庫設置以外的所有變量，請參見config.default.php有關有效值
  • 確保uploads文件夾（用於從客戶端應用上載的圖像）是由PHP寫作的
  • 清除瀏覽器緩存和重新啟動網頁

Docker

• 運行docker run --name ulogger -p 8080:80 -d bfabiszewski/ulogger和訪問http://localhost:8080在您的瀏覽器中。使用admin登錄： admin憑據和更改默認密碼
• 帶有Env變量的可選配置選項，有關列表，請參見Dockerfile。變量對應於主μlogger配置參數
• 例如： docker run --name ulogger -e ULOGGER_LANG="pl" -p 8080:80 -d bfabiszewski/ulogger
• 您也可以自己構建圖像。運行docker build .從Dockerfile居住的根文件夾中。有可選的構建時間參數，可讓您為root和ulogger用戶設置默認數據庫密碼
• 例如： docker build --build-arg DB_ROOT_PASS=secret1 --build-arg DB_USER_PASS=secret2 --build-arg DB_DRIVER=sqlite .
• Docker的創建是為了促進開發和測試。它還沒有準備好。如果您想在生產中使用它，則必鬚根據您的需求進行調整。

測試

• 安裝測試依賴性。 PHP測試需要PHP> = 7.3。
  • composer install
  • npm install
• 集成測試可以針對Docker圖像進行。我們需要曝光的HTTP和可選的數據庫端口（例如，映射到Localhost 8080和8081）。下面的MySQL設置示例
  • docker build -t ulogger .
  • docker run -d --name ulogger -p 8080:80 -p 8081:3306 --expose 3306 -e ULOGGER_ENABLE_SETUP=1 ulogger
• 使用環境變量（或在.tests/文件夾中創建.env文件）來設置連接詳細信息（在數據庫憑據是Docker默認值下方）
  • DB_DSN="mysql:host=127.0.0.1;port=8081;dbname=ulogger;charset=utf8"
  • DB_USER=ulogger
  • DB_PASS=secret2
  • ULOGGER_URL="http://127.0.0.1:8080"
• PHP測試
  • XDEBUG_MODE=coverage ./vendor/bin/phpunit -c .tests/phpunit.xml
• JS測試
  • npm test
• 其他測試
  • npm run lint:js
  • npm run lint:css

翻譯

• 翻譯可以通過Transife進行貢獻

捐

bc1qt3uwhze9x8tj6v73c587gprhufg9uur0rzxhvh
0x100C31C781C8124661413ed6d1AA9B1e2328fFA2

執照

• GPL
• 大多數圖標來自IconMonstr