Variáveis de inicialização ms_configura.php

Nesse programa PHP são definidas as variáveis globais principais necessárias ao funcionamento do I3Geo do lado do servidor web.

O ms_configura é incluído em vários programas do i3Geo e os valores das variáveis devem ser editados caso a instalação do i3geo tenha sido feita em um diretório diferente do padrão.  No windows o diretório padrão é c:\ms4w\apache\htdocs\i3geo e no linux é /opt/www/html/i3geo

Para verificar a instalação do i3geo utilize o programa i3geo/testainstal.php, que pode fornecer algumas dicas caso estejam ocorrendo problemas na iniciallização.

As variáveis de configuração são definidas em blocos diferentes conforme o sistema operacional (linux ou windows).

O ms_criamapa.php carrega o ms_configura.php e armazena a maior parte das variáveis na seção.  Algumas variáveis são também fornecidas para o cliente (navegador) na inicialização do mapa e ficam disponíveis em variáveis javascript.

Qualquer uma das variáveis pode ser colocada dentro do bloco que identifica o sistema operacional.  Dessa forma pode-se ter um comportamento diferente de acordo com o ambiente.

Licenca

GPL2

i3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet

Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti edmar..nosp@m.moretti@gmai.nosp@m.l.com

Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation;

Este programa é distribuído na expectativa de que seja útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE OU ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA.  Consulte a Licença Pública Geral do GNU para mais detalhes.  Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., no endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA. i3geo/testamapfile.php Arquivo: ms_configura.php

Summary
Variáveis de inicialização ms_configura.phpNesse programa PHP são definidas as variáveis globais principais necessárias ao funcionamento do I3Geo do lado do servidor web.
Variaveis
i3geomasterUsuário e senha que podem realizar operações de administração inicial do i3Geo, como a criação do banco de dados de administração ou operações críticas do sistema
saikuUrlURL para acessar o aplicativo SAIKU.
saikuConfigDataSourceParametros de configuracao da fonte de dados utilizada pelo applicativo SAIKU
i3georendermodeOpcoes que definem a rotina que sera utilizada para enviar ao navegador as imagens geradas de cada camada
linkedinoauth (ainda não implementado)Parâmetros registrados no Linkedin para permitir que o i3Geo faça autenticação com base na conta do usuário
facebookoauthParâmetros registrados no Facebook para permitir que o i3Geo faça autenticação com base na conta do usuário
twitteroauthParâmetros registrados no Twitter para permitir que o i3Geo faça autenticação com base na conta do usuário
mensagemIniciaMensagem de inicialização mostrada pelo programa ms_criamapa.php
tituloInstituicaoNome que será utilizado em alguns cabeçalhos e títulos de páginas
emailInstituicaoEndereço de e-mail que pode ser mostrado na interface do mapa
googleApiKeyChave utilizada pela API do Google maps.
metaestatTemplatesIndica a pasta onde ficam os templates utilizados para a publicacao de mapas.
navegadoresLocaisIp dos usuarios que podem navegar no servidor para acessar arquivos de dados geográficos.
dir_tmpCaminho completo do diretório temporário utilizado pelo mapserver.
locaplicCaminho completo onde fica o I3Geo
locmapservLocalização do executável do Mapserver conforme deve ser acrescentado a URL após o nome do host.
locmapasOnde fica o xml, para preencher a guia mapas.
R_pathOnde esta o executavel do software R
R_pathlibOnde ficam as bibliotecas adicionais necessárias ao funcionamento do R
postgis_mapaString de conexão para acesso aos dados (opcional).
utilizacgiVariável indicando se o desenho do corpo do mapa será baseado no modo cgi.
expoeMapfileEssa variável controla se o nome do mapfile atual será ou não retornado para a aplicação via ajax.
conexaoadminArquivo PHP que define a string de conexão (PDO) com o banco de dados administrativo.
$esquemaadminIndica em qual esquema do banco de dados de administração estão armazenadas as tabelas do sistema de administração.
interfacePadraoInterface padrão utilizada para abrir o mapa.
baseEnderço do arquivo mapfile que será utilizado como base para a criação do mapa
cachedirPasta onde ficarão armazenadas as imagens geradas pelo i3Geo para os LAYERS que permitem cache.
ogcwsmapNome (caminho completo) do arquivo mapfile que sera utilizado como base para a construcao dos servicos OGC

Variaveis

i3geomaster

Usuário e senha que podem realizar operações de administração inicial do i3Geo, como a criação do banco de dados de administração ou operações críticas do sistema

É necessário alterar esse parâmetro quando o i3Geo não estiver em localhost, caso contrário, os mapas serão bloqueados

Tipo

{array}

Default

array(array(“usuario”=>”admin”, “senha”=>”adminx”));

saikuUrl

URL para acessar o aplicativo SAIKU.  Se nao estiver instalado, deixe em branco

Para maiores informacoes sobre como instalar o SAIKU veja em http://localhost/i3geo/ferramentas/saiku/instal.txt

saikuConfigDataSource

Parametros de configuracao da fonte de dados utilizada pelo applicativo SAIKU

Indicam onde estao os dados utilizados pelo sistema de metadados estatisticos e que podem ser visualizados na forma de cubos OLAP

Ajuste os parametros indicando

serverdbendereco do servidor postgres
portporta de acesso ao servidor
databasenome do database que contem as tabelas
usernamenome do usuario que pode acessar o database
passwordsenha desse usuario

Os parametros sao utilizados pelo programa definido em Catalog.  Ese programa monta o arquivo de fonte de dados temorario e armazena em ms_tmp/saiku-datasources

Esse arquivo contera uma string como esse exemplo

type=OLAP driver=mondrian.olap4j.MondrianOlap4jDriver location=jdbc:mondrian:Jdbc=jdbc:postgresql://localhost:5432/i3geosaude;Catalog=http://localhost/i3geo/ferramentas/saiku/esquemaxml.php;JdbcDrivers=org.postgresql.Driver; username=postgres password=postgres

Note que o database possui o nome i3geosaude Se os seus dados estatisticos estiverem em outro banco altere esse valor

Em tabelaDimensaoTempo utilize nome_do_esquema.nome_da_tabela

i3georendermode

Opcoes que definem a rotina que sera utilizada para enviar ao navegador as imagens geradas de cada camada

0modo default.  Utiliza a funcao imagepng() do PHP para enviar a imagem ao navegador
1utiliza a funcao do Mapserver saveImage() para enviar a imagem ao navegador (e mais rapida, mas nao funciona em algumas versoes do Mapserver)
2utiliza X-Sendfile (mais rapido que as outras opcoes) mas exige modificacoes na instalacao do Apache.  Veja em: https://tn123.org/mod_xsendfile/ e http://edmarmoretti.blogspot.com.br/

linkedinoauth (ainda não implementado)

Parâmetros registrados no Linkedin para permitir que o i3Geo faça autenticação com base na conta do usuário

O Linkedin exige que cada site seja registrado para permitir que a API de autenticação funcione

Veja o site para maiores informações: http://developer.linkedin.com/docs/DOC-1008

Caso vc não queira permitir essa opção, deixe essa variável vazia, e.x

Ao registrai3geo/testamapfile.phpr utilize o valor http://meuservidor/i3geo/pacotes/openid/login.php?login

Exemplo

$linkedinoauth = array( “consumerkey” => “0oQ30ge-ggKarx4HGaXVK118n8mekMBbFYTrC-agGV9hvxUXfeWwS1q7ZMvD-8LL”, “consumersecret” => “nRGXfHp1XNMt0eCG7tWJpoCcXX1uoZseDtgiU-CRy1ajqipo4KpjjZdDUXmqZGQA” );

Tipo

{array}

facebookoauth

Parâmetros registrados no Facebook para permitir que o i3Geo faça autenticação com base na conta do usuário

O Facebook exige que cada site seja registrado para permitir que a API de autenticação funcione

Veja o site para maiores informações: http://developers.facebook.com/setup/

Caso vc não queira permitir essa opção, deixe essa variável vazia, e.x

Ao registrar utilize o valor http://meuservidor/i3geo/pacotes/openid/login.php?login

Exemplo

$facebookoauth = array( “consumerkey” => “136279263094148”, “consumersecret” => “679fc4a007b1d289377fa8af8f7086b6” );

Tipo

{array}

twitteroauth

Parâmetros registrados no Twitter para permitir que o i3Geo faça autenticação com base na conta do usuário

O Twitter exige que cada site seja registrado para permitir que a API de autenticação funcione

Veja o site para maiores informações: http://www.snipe.net/2009/07/writing-your-first-twitter-application-with-oauth/

Lista de aplicações cadastradas: https://twitter.com/oauth_clients/

Caso vc não queira permitir essa opção, deixe essa variável vazia, e.x

$twitteroauth = “”;

Ao registrar a aplicação, utilize o endereço do i3geo em Application Website, por exemplo http://meuservidor/i3geo

Ao registrar utilize como “Callback URL” o valor http://meuservidor/i3geo/pacotes/openid/login.php?login

Exemplo

$twitteroauth = array( “consumerkey” => “vUvBcsOULjS0ewxuSvbS6w”, “consumersecret” => “0Hj6uCyycDCeNOgzTUF1bBSel75KtfbnCS4bxWVqaxk”, “requesttokenurl” => “https://twitter.com/oauth/request_token”, “accesstokenurl” => “https://twitter.com/oauth/access_token”, “authorizeurl” => “https://twitter.com/oauth/authorize” );

Tipo

{array}

mensagemInicia

Mensagem de inicialização mostrada pelo programa ms_criamapa.php

É obtida de um include para permitir a atualização da versão nos pacotes de correção

Tipo

{string}

tituloInstituicao

Nome que será utilizado em alguns cabeçalhos e títulos de páginas

Tipo

{string}

emailInstituicao

Endereço de e-mail que pode ser mostrado na interface do mapa

Tipo

{string}

googleApiKey

Chave utilizada pela API do Google maps.

A API do Google maps é utilizada em algumas funcionalidades do i3geo.  Vc deve registrar uma chave no site do Google para o seu endereço de servidor web. veja como fazer em: http://code.google.com/apis/maps/signup.html

Tipo

{string}

metaestatTemplates

Indica a pasta onde ficam os templates utilizados para a publicacao de mapas.  E utilizado pelo sistema de metadados estatisticos.  O default e a pasta /ferramentas/metaestat/templates A pasta deve estar dentro do diretorio onde esta instalado o i3geo A pasta com os templates deve conter uma pasta chamada “logos” para guardar as logomarcas utilizadas pelos mapas

Tipo

{string}

navegadoresLocais

Ip dos usuarios que podem navegar no servidor para acessar arquivos de dados geográficos.

O i3geo possibilita que os usuários acessem dados geográficos no servidor diretamente, navegando pelo sistema de arquivos.  Isso possibilita o acesso aos dados mesmo que não constem na árvore de temas Por segurança, essa funcionalidade só é ativada apenas quando o usuario estiver logado.

Caso o usuário não esteja logado, será mostrada para navegacao apenas a pasta i3geo/data

Se objmapa.navegacaoDir for igual a “sim”, ou seja, $navegadoresLocais é diferente de “”, na guia de adição de temas da interface HTML, será mostrada a opção de navegação.  Portanto, se vc não quiser que essa opção seja ativada, mantenha essa variável igual a

$navegadoresLocais = “”;

Para efeito de compatibilidade, manteve-se a possibilidade de um array com multiplos arrays, mas apenas o primeiro e utilizado

Tipo

{array}

dir_tmp

Caminho completo do diretório temporário utilizado pelo mapserver.

Tipo

{string}

locaplic

Caminho completo onde fica o I3Geo

Tipo

{string}

locmapserv

Localização do executável do Mapserver conforme deve ser acrescentado a URL após o nome do host.

Essa variável é necessária em processos que utilizam o mapserver no modo CGI.

Por exemplo, se o endereço for http://localhost/cgi-bin/mapserv.exe, a variável deverá conter apenas /cgi-bin/mapserv.exe

Tipo

{string}

locmapas

Onde fica o xml, para preencher a guia mapas.

Se for “” será utilizado o sistema de administração do i3geo (veja i3geo/admin).

A guia “Mapas” mostra uma lista de links que permitem abrir mapas específicos.  Essa lista é utilizada também pela versão mobile do i3geo.

Veja a documentação específica do arquivo mapas.xml para maiores detalhes.

Tipo

{string}

R_path

Onde esta o executavel do software R

O R é um pacote estatístico utilizado pelo I3Geo para geração de gráficos e análises estatísticas Se vc não possui o R instalado, comente a linha abaixo

Tipo

{string}

R_pathlib

Onde ficam as bibliotecas adicionais necessárias ao funcionamento do R

Instale no R as bibliotecas SPATSTAT e DELDIR.  No Ubuntu, experimente usar o software RKWard que possui um instalador de bibliotecas

Tipo

{string}

postgis_mapa

String de conexão para acesso aos dados (opcional).

Prefira usar o esquema de criptografia nativo do Mapserver, veja em

http://mapserver.org/utilities/msencrypt.html

Com o uso opcional dessa variável é possível esconder a string de conexão com o banco de dados.  O Mapserver não permite esconder essa string, por isso, no i3geo, foi implementado um esquema de substituição.  Toda vez que um objeto “map” é criado via PHP Mapscript, a string de conexão é substituída pelo valor de $postgis_mapa.  Se não for desejado a substituição, deixe essa variável em branco.  Se vc especificar essa variável, o mapa será forçado a recusar o modo de operação CGI.

Para mais detalhes veja a função substituiCon em classesphp/funcoes_gerais.php

exemplo -

$postgis_mapa = array( “teste”=>”user=geodados password=geodados dbname=geodados host=10.1.1.36 port=5432”, “conexao2”=>”user=geodados password=geodados dbname=geodadosteste host=10.1.1.36 port=5432” )

No exemplo, vc pode usar “teste” ou “conexao2” no seu mapfile veja em i3geo/temas/testesubstring.map

Se vc não quiser usar essa substituição, deixe como está ou use

$postgis_mapa = “”

Tipo

{array ou string}

utilizacgi

Variável indicando se o desenho do corpo do mapa será baseado no modo cgi.

Por default, o mapserver desenha o mapa via php, porém, pode-se alterar o modo de desenho.

No modo normal, a imagem do mapa é gerada e armazenada no diretório ms_tmp.  Após a geração da imagem

  • endereço do arquivo é retornado ao mapa (retorno via Ajax) e o javascript se encarrega de alterar o endereço da imagem no navegador.  Com o uso do CGI a imagem não é gerada, sendo repassado ao navegador
  • endereço do cgi acrescentado do nome do mapfile, fazendo com que a imagem seja retornada diretamente.

Em alguns casos o uso do cgi torna a aplicação mais rápida.

Tipo

{string}

expoeMapfile

Essa variável controla se o nome do mapfile atual será ou não retornado para a aplicação via ajax.

Quando essa variável for definida como “nao” algumas das funcionalidades do i3geo poderão ficar prejudicadas, mas sem comprometimento das funções principais.

Tipo

{string}

conexaoadmin

Arquivo PHP que define a string de conexão (PDO) com o banco de dados administrativo.

Esse arquivo é incluído no programa i3geo/admin/conexao.php

O banco de dados administrativo é utilizado para definir coisas como a árvore de temas, árvore de mapas, etc.

O banco de dados, originalmente, é montado em SQLITE, porém, em ambientes corporativos, sugere-se o uso de bancos de dados mais robustos.

Se você quiser utilizar a conexão default, baseado no SQLITE, mantenha essa variável vazia.

O programa PHP que estabelece a conexão deve retornar objetos com nomes padronizados.  Veja o arquivo i3geo/admin/conexao.php e i3geo/admin/php/conexaopostgresql.php para maiores detalhes.

Exemplos

$conexaoadmin = $locaplic.”/admin/php/conexaopostgresql.php”; $conexaoadmin = $locaplic.”/admin/php/conexaomma.php”;

Tipo

{string}

$esquemaadmin

Indica em qual esquema do banco de dados de administração estão armazenadas as tabelas do sistema de administração.  Por default, utiliza-se o esquema public.

Tipo

{string}

interfacePadrao

Interface padrão utilizada para abrir o mapa.

A interface pode ser um arquivo com as extensões .htm .html .phtml

O arquivo deve estar armazenado em i3geo/aplicmap

A interface padrão é utilizada quando não é definida nenhuma interface via URL.

Tipo

{string}

base

Enderço do arquivo mapfile que será utilizado como base para a criação do mapa

Se vc não usar o caminho completo, o arquivo será procurado em i3geo/aplicmap

Quando não for definido, o i3Geo tentará escolher o mapfile mais adequado, conforme o que existir em i3geo/aplicmap

A escolha depende do sistema operacional e da versão do Mapserver.

Vc pode usar essa variável para customizar a inicialização do mapa.

Tipo

{string}

cachedir

Pasta onde ficarão armazenadas as imagens geradas pelo i3Geo para os LAYERS que permitem cache.

Os layers que permitem cache são definidos no sistema de administração do i3Geo.

Se cachedir for vazia, será utilizado o default do i3geo (diretório temporário)

Exemplo

$cachedir = ‘c:/temp/cache’;

Tipo

{string}

ogcwsmap

Nome (caminho completo) do arquivo mapfile que sera utilizado como base para a construcao dos servicos OGC

Esse mapfile deve conter os parametros de OWS conforme o default

Se for vazio sera utilizado o default, que depende da versao do mapserver instalado

Os arquivos default ficam na pasta i3geo/aplicmap/ogcws*.map

Uilize um desses para criar o seu proprio arquivo e customizar os parametros desejados

Tipo

{string}