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