Este é um aplicativo da Web para a coleção em tempo real de dados de geolocalização, rastreamentos e gerenciamento. Juntamente com um cliente móvel μlogger dedicado, ele pode ser usado como uma solução de servidor -cliente completa hospedada para registro e monitoramento da geolocalização dos usuários.
Demonstração ao vivo:
- https://ulogger.lima.zone
- Para testar o upload da faixa com o aplicativo Android ou o login de edição de rastreamento com usuário: demonstração, senha: demonstração
- Hospedado por Lima-city.de
Requisitos mínimos:
- Php 5.5
- Extensões PHP: CTYPE, JSON, PDO (com os respectivos drivers), Sessão, Simplexml, XMLWriter, Xdebug (apenas para testes)
- MySQL, PostgreSQL ou Sqlite (Over PDO Driver)
- navegador com JavaScript ativado, cookies para autenticação e preferências de economia
Características:
- simples
- permite rastreamento ao vivo
- Estatísticas de rastreamento
- Gráfico de altitudes
- vários usuários
- autenticação do usuário
- Google Maps
- OpenLayers (OpenStreet e outras camadas)
- Preferências do usuário armazenadas em cookies
- menu de administrador simples
- Exportar faixas para GPX e KML
- Importar faixas de gpx
Instalar
- Baixe o arquivo zippeado ou clone o repositório em seu computador
- Mova -o para o diretório do seu servidor da web (descompacente, se necessário)
- Corrigir Pasta Permissões: Pasta
uploads (para Imagens Carregadas) deve ser escrito por scripts PHP - Em caso de versão de desenvolvimento, é necessário criar um pacote JavaScript a partir de arquivos de origem. Você precisará instalar
npm e executar npm install e npm run build na pasta raiz - Crie usuário de banco de dados e banco de dados (pelo menos selecione, insira, atualize, exclua privilégios, crie, queda para script de configuração, sequências para postgreSQL)
- Crie uma cópia do
config.default.php e renomeie -o para config.php . Personalize e adicione credenciais de banco de dados - Editar
scripts/setup.php Script, habilitá -lo definindo o valor ativado $ ativado como true - Certifique -se de ter um servidor da web em execução com PHP e banco de dados escolhido
- Abrir http: //your_host/ulogger-sever/scripts/setup.php Page em seu navegador
- Siga as instruções no script de configuração. Ele adicionará tabelas de banco de dados e configurará seu usuário μlogger
- Lembre -se de remover ou desativar
scripts/setup.php script - Faça login com seu novo usuário em http: // your_host/ulogger-sever/
- Você também pode definir seu novo usuário como um administrador no arquivo de configuração
- Pastas
.docker/ e .tests/ assim como arquivos compositor são necessários apenas para desenvolvimento. Pode ser removido com segurança
Atualizar para a versão 1.x
- Alterações incompatíveis incluem bancos de dados e alterações de arquivo de configuração
- Atualizando manualmente:
- Para alterações no banco de dados, consulte MySQL Exemplo de script em
scripts/migrate_to_1_x.mysql - Defina a coluna
admin na tabela users como true para usuários administrativos - Editar configuração da caixa de diálogo Configurações do aplicativo
- Atualização com o script de migração da versão 0.6:
- Crie backup de banco de dados
- Substitua todos os arquivos de projeto por novos, mas mantenha o arquivo de configuração local antigo:
config.php - Altere o diretório para a pasta raiz do aplicativo e execute o script de migração do console:
php scripts/migrate_to_1_x.php - O script atualizará o esquema do banco de dados e salvará variáveis antigas de configuração no banco de dados
- Tarefas adicionais após atualização manual ou script:
- Edite seu arquivo
config.php e remova todas as variáveis, exceto as configurações do banco de dados, consulte Config.Default.php para valores válidos - Verifique se a pasta
uploads (para imagens enviadas do aplicativo cliente) é gravável por php - Limpar o cache do navegador e reiniciar a página da web
Docker
- Run
docker run --name ulogger -p 8080:80 -d bfabiszewski/ulogger e acesse http://localhost:8080 no seu navegador. Faça login com admin : credenciais admin e altere a senha padrão - Opções de configuração opcionais com variáveis ENV, para lista, consulte o Dockerfile. As variáveis correspondem aos principais parâmetros de configuração μlogger
- Por exemplo:
docker run --name ulogger -e ULOGGER_LANG="pl" -p 8080:80 -d bfabiszewski/ulogger - Você também pode construir a imagem. Run
docker build . Na pasta raiz onde residem Dockerfile . Existem argumentos opcionais no tempo de construção que permitem definir senhas de banco de dados padrão para usuários root e ulugger - Por exemplo:
docker build --build-arg DB_ROOT_PASS=secret1 --build-arg DB_USER_PASS=secret2 --build-arg DB_DRIVER=sqlite . - O Docker foi criado para facilitar o desenvolvimento e o teste. Não está pronto para a produção. Se você quiser usá -lo na produção, precisará ajustá -lo às suas necessidades.
Testes
- Instale os testes dependentes. Os testes PHP requerem pHP> = 7.3.
-
composer install -
npm install
- Os testes de integração podem ser executados contra a imagem do Docker. Precisamos de portas HTTP expostas e opcionalmente no banco de dados (por exemplo, mapeado para localhost 8080 e 8081). Exemplo abaixo para configuração MySQL
-
docker build -t ulogger . -
docker run -d --name ulogger -p 8080:80 -p 8081:3306 --expose 3306 -e ULOGGER_ENABLE_SETUP=1 ulogger
- Use variáveis de ambiente (ou crie arquivo
.env em .tests/ pasta) para configurar os detalhes da conexão (as credenciais abaixo do banco de dados são padrões do 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"
- Testes PHP
-
XDEBUG_MODE=coverage ./vendor/bin/phpunit -c .tests/phpunit.xml
- Testes JS
- Outros testes
-
npm run lint:js -
npm run lint:css
Traduções
- As traduções podem ser contribuídas via transifex
Doar
bc1qt3uwhze9x8tj6v73c587gprhufg9uur0rzxhvh
0x100C31C781C8124661413ed6d1AA9B1e2328fFA2
Licença
- Gpl
- A maioria dos ícones vem de IConMonstr