Forem: PHPWomenBR

Manipulação de arquivos csv no PHP

Daiane Alves — Mon, 15 Jun 2020 16:05:48 +0000

Manipulação de arquivos `csv` com PHP

O formato csv é um tipo de arquivo de texto bastante utilizado para transferência de informações entre diferentes aplicações e também para geração de relatório.

E para fazer esse tipo de troca de informações com sucesso, você precisa saber como manipular esses arquivos.

Em linhas gerais, o csv é um formato usado para armazenar dados e que pode ser lido em programas que trabalham com planilhas.

O que é `csv`?

Mas, antes de trabalhar com arquivos csv no PHP, é importante entender em que consiste essa sigla. Por definição, csv é um formato de arquivo que significa “comma-separated-values” (valores separados por vírgulas), ou seja,os campos de dados indicados neste formato normalmente são separados ou delimitados por uma vírgula.

Para entender de uma forma mais prática, vamos supor que você tenha uma planilha que contenha os dados a seguir:

Daiane	daiane@teste.com	912345678
Adriele	drica@teste.com	987654321
Livia	livia@teste.com	876543456
Bruna	bruna@teste.com	998765678

Esses dados poderiam ser lidos em um arquivo csv separados por vírgulas e por um espaçamento de linha, como no exemplo a seguir:

Daiane,daiane@teste.com,912345678
Adriele,drica@teste.com,987654321
Livia,livia@teste.com,876543456
Bruna,bruna@teste.com,998765678

Agora que você já entendeu o conceito básico sobre csv, vamos aprender como podemos utilizar o PHP para fazer a manipulação desses arquivos.

OBS: CSV é separado por vírgula e não ponto e vírgula.

Abrindo um arquivo `csv` existente

A função fopen() pode ser utilizada tanto para abrir um arquivo quanto para criar um novo.

Neste exemplo, vamos mostrar como abrir um arquivo existente. A função fopen() recebe dois argumentos, o primeiro argumento recebe o nome do arquivo que deseja abrir e no segundo argumento o tipo de permissão(leitura, escrita, leitura e escrita...).

$arquivo = fopen('nomeArquivo.csv', 'w');

Criando um arquivo `csv`

Podemos também utilizar a função fopen() para criar nosso arquivo .csv.
Veja o exemplo:

//Abrir ou criar arquivo
$arquivo = fopen('file.csv', 'w');

Ao executar esta função é criado automaticamente um arquivo vazio (com permissão de escrita, neste caso).

Nota: a função fopen() pode ser utilizada para criar qualquer tipo de arquivo, basta colocar a extensão que deseja. Exemplo: arquivo.txt, arquivo.pdf, arquivo.xls.

Inserindo dados no arquivo `csv`

Existem algumas maneiras de inserir dados em um arquivo csv, uma delas é abrir o próprio arquivo e inserir os dados manualmente separados por vírgula. Mas, não é isso que iremos aprender...

Vamos usar nosso bom e velho amigo PHP para isso!

Para isso podemos utilizar a função fputcsv(). Ela formata uma linha (passada como um array de campos fields) como CSV e a escreve (terminando com uma nova linha) no manipulador de arquivo especificado por handle.

Sintaxe

fputcsv($handle, $fields, $delimiter, $enclosure, $escape_char);

Parâmetros

$handle - O ponteiro de arquivo precisa ser válido, e apontar para um arquivo aberto por fopen() (e ainda não fechado por fclose()).
$fields - Um array de valores.
$delimiter- O parâmetro opcional delimiter configura o caractere delimitador (apenas um caractere). O padrão é vírgula.
$enclosure- O parâmetro opcional enclosure configura o caractere que envolve os dados (apenas um caractere). O padrão é aspas, utilizado quando se tem quebra de linha ou vírgulas dentro do texto.
$escape_char- O parâmetro opcional escape_char configura o caractere de escape (apenas um caractere). Utilizado para fazer o escape de uma aspa no meio de uma string.

Veja o exemplo abaixo:

$dados = [
    [
        'produto' => 'Notebook',
        'preco' => 3587,
    ],
    [
        'produto' => 'Celular',
        'preco' => 2643,
    ],
    [
        'produto' => 'TV',
        'preco' => 5876,
    ],
    [
        'produto' => 'Fone',
        'preco' => 432,
    ],
];

// Abrir/criar arquivo
$arquivo = fopen('file.csv', 'w');

// Popular os dados
foreach ($dados as $linha) {
    fputcsv($arquivo, $linha);
}

// Fechar o arquivo
fclose($arquivo);

Neste exemplo começamos nosso arquivo criando um array que contém produtos e preços.
Em seguida, criamos a variável $arquivo que está recebendo a função fopen()para criar um novo arquivo.
Depois criamos um foreach para percorrer nosso array e usamos a função fputcsv() para gerar o output do csv.
E por último usamos a função fclose() para fechar o arquivo.

Ao executar este código teremos como saída:

Notebook,3587
Celular,2643
TV,5876
Fone,432

Criando cabeçalho

O exemplo acima é bem útil, mas está faltando algo... Precisamos criar cabeçalhos pra nossa tabela final ficar mais intuitiva. Vamos lá?

// Cabeçalho do csv
$headers = ['Produto', 'Preço'];

$dados = [
    [
        'produto' => 'Notebook',
        'preco' => 3587,
    ],
    [
        'produto' => 'Celular',
        'preco' => 2643,
    ],
    [
        'produto' => 'TV',
        'preco' => 5876,
    ],
    [
        'produto' => 'Fone',
        'preco' => 432,
    ],
];

$arquivo = fopen('file.csv', 'w');

// Criar o cabeçalho
fputcsv($arquivo , $headers);

foreach ($dados as $linha ) {
    fputcsv($arquivo, $linha);
}

fclose($arquivo);

Manipulando os dados

Imagine que você necessite colocar os produtos em ordem alfabética. Podemos utilizar a função array_multisort().

Veja o exemplo:

$headers = ['Produto', 'Preço'];

$dados = [
    [
        'produto' => 'Notebook',
        'preco' => 3587,
    ],
    [
        'produto' => 'Celular',
        'preco' => 2643,
    ],
    [
        'produto' => 'TV',
        'preco' => 5876,
    ],
    [
        'produto' => 'Fone',
        'preco' => 432,
    ],
];

$arquivo = fopen('file.csv', 'w');

fputcsv($arquivo , $headers);

foreach ($dados as $chave => $valor) {
    $produto[$chave]  = $valor['produto'];
    $preco[$chave] = $valor['preco'];
}

// Ordenar array dados na coluna produto em ordem crescente.
// Pode usar SORT_DESC para ordem decrescente.
array_multisort($produto, SORT_ASC, $dados);

foreach ($dados as $linha ){
    fputcsv($arquivo, $linha);
}

fclose($arquivo);

Aqui nós utilizamos a função array_multisort() para fazer a ordenação do nosso array. Para saber mais, consulte o manual do PHP.

Organizando preços em ordem decrescente

Você também pode ordenar os preços utilizando a função array_multisort().

Veja o exemplo:

$headers = ['Produto', 'Preço'];

$dados = [
    [
        'produto' => 'Notebook',
        'preco' => 3587,
    ],
    [
        'produto' => 'Celular',
        'preco' => 2643,
    ],
    [
        'produto' => 'TV',
        'preco' => 5876,
    ],
    [
        'produto' => 'Fone',
        'preco' => 432,
    ],
];

$arquivo = fopen('file.csv', 'w');

fputcsv($arquivo , $headers);

foreach ($dados as $chave => $valor) {
    $produto[$chave]  = $valor['produto'];
    $preco[$chave] = $valor['preco'];
}
// SORT_ASC para ordem crescente
array_multisort($preco, SORT_ASC, $dados);

foreach ($dados as $linha) {
    fputcsv($arquivo, $linha);
}
fclose($arquivo);

OBS: fclose em muitos casos se faz desnecessário pois o PHP já fecha automaticamente quando encerra a execução de um script. É bom fechar mais para reduzir consumo de memória em scripts que fazem muita coisa como manipulação de muitos CSV.

Lendo um arquivo `csv` existente

No exemplo anterior, vimos que é possível criar e manipular arquivos csv no PHP, agora vamos trabalhar com arquivos csv já existentes. Para isso vamos utilizar a função fgetcsv().

A função fgetcsv() interpreta a linha em busca de campos no formato csv e retorna um array contendo os campos lidos. Para conhecer um pouco mais sobre ela, acesse o manual do PHP.
Veja o exemplo:

$handle = fopen("nota.csv", "r");

$header = fgetcsv($handle, 1000, ",");

while ($row = fgetcsv($handle, 1000, ",")) {
    $nota[] = array_combine($header, $row);
}
print_r($nota);

fclose($handle);

Executando esse código teríamos como saída:

Array
(
    [0] => Array
        (
            [N°da Nota Fiscal] => 87
            [Data da Emissão] => 31/05/2020
            [Hora da Emissão] => 14:27:25
            [Valor] => 23764,40
        )

    [1] => Array
        (
            [N°da Nota Fiscal] => 86
            [Data da Emissão] => 27/05/2020 
            [Hora da Emissão] => 14:25:00
            [Valor] => 549873,0
        )

    [2] => Array
        (
            [N°da Nota Fiscal] => 85
            [Data da Emissão] => 27/05/2020 
            [Hora da Emissão] => 14:03:41
            [Valor] => 25876
        )

    [3] => Array
        (
            [N°da Nota Fiscal] => 84
            [Data da Emissão] => 18/05/2020 
            [Hora da Emissão] => 16:55:43
            [Valor] => 150000
        )

)

E a partir daí você pode trabalhar com este arquivo da maneira que desejar.
Esperamos que tenha curtido e bons estudos!

MeetJitsi - Ferramenta Open Source para vídeo conferência

Daiane Alves — Sun, 15 Mar 2020 03:27:38 +0000

Devido a pandemia de Covid-19, muitas empresas adotaram o trabalho remoto como alternativa de prevenção a doença. O que muita gente não sabe é que este modelo de trabalho já existe oficialmente aqui no Brasil desde 1997 e surgiu durante o Seminário Home Office/Telecommuting – Perspectivas de Negócios e de Trabalho para o Terceiro Milênio e atualmente já é uma realidade em muitas empresas no Brasil e no exterior.

Segundo a IBOPE Conecta,para 85% dos profissionais, reuniões remotas já oferecem experiência tão positiva quanto presenciais e não deixam nada a desejar e isso eu posso confirmar!

Pensando nisso, vim mostrar uma ferramenta que utilizamos demais no nosso dia a dia para fazer nossas reuniões on line (tanto pelo computador como no celular): o MeetJitsi.

O MeetJitsi é uma solução de vídeo conferência Open Source, 100% criptografada e você pode utilizar sem precisar criar conta. Incrível, não é mesmo?!

Para utilizar:

Acesse (de preferência) no Google Chrome ou Chromium o site MeetJitsi,
Crie um nome para sua sala reunião.
Clique no botão ir ou go.
Ative as permissões de acesso a sua câmera e seu microfone.

E pronto! Sua sala de reuniões está pronta para ser utilizada, agora é só compartilhar o link com seus convidados. Simples assim...

Fácil demais! E pode ser ainda mais fácil!

Você pode simplificar todo este processo digitando a url direto no navegador. Exemplo: https://meet.jitsi/NomeDaSala e sempre que precisar daquela sala é só usar, não é necessário criar uma sala nova para cada vez que for usar (a menos que você queira).

Além disso, você ainda pode sincronizar e com sua agenda e ser notificado de suas reuniões.

Conhecendo a interface

Compartilhar tela. Com esta opção você pode compartilhar a sua tela com seus convidados. Além disso, você pode escolher qual janela você quer compartilhar.
Erguer / baixar mãos - com esta opção, você pode acenar para dizer que quer falar alguma coisa.
Abrir/fechar bate-papo - Você pode usar esta opção para abrir um chat simultâneo com todas as pessoas da sala. É útil para caso você deseja compartilhar um link, por exemplo.
Mudo/não mudo - Aqui você pode ativar e desativar seu microfone.
Encerrar chamada.
Ativar e desativar câmera.
Alternar visualização em blocos - Aqui você pode visualizar todos os participantes da sala em bloco.
Compartilhar link e discagem para esta reunião - Você pode utilizá-lo para compartilhar com seus convidados.
Mais ações - Nesta opção tem uma série de recursos extras como: gravar, configurar, compartilhar no youtube e várias outras coisas. 10- URL da sua sala - como já foi dito no começo deste artigo, você pode criar uma url personalizada para sua sala. Exemplo: https://meet.jitsi/NomeDaSala e sempre que precisar daquela sala é só usar, não é necessário criar uma sala nova para cada vez que for usar (a menos que você queira).
Tempo de duração da sua reunião.

Pronto! Agora você já sabe tudo que precisa para realizar suas vídeo conferências, é só aproveitar!

Por mais mulheres na tecnologia: Grupo de incentivo PHPWomen-BR

Viviane Nonato — Fri, 07 Feb 2020 16:03:51 +0000

Sabemos que a inclusão da mulher nas áreas de ciência e tecnologia é imprescindível para que inovações como essas aconteçam e transformem o mundo para melhor. Com isto, a comunidade PHPWomen vem trazendo eventos periódicos que estimulam e incentivam mulheres a programar, ajudando também a inseri-las no mercado de trabalho.

No dia 20 de julho de 2019, aconteceu mais um encontro do PHPWomen, na Infnet, unidade Rio de Janeiro. Uma das responsáveis pela coordenação é a mentora Daiane Alves, analista de sistemas e estudante de Sistemas de Informação. Um evento de mulheres organizados por mulheres, que contou com a colaboração de Adriele Ribeiro, professora da FUNDEC, ministrando aulas de programação, dando uma oficina de quase 8 horas de estudo, exercícios práticos e aperfeiçoamento da linguagem PHP. As participantes contaram com mentorias técnicas para quem estivesse com dúvidas, pela engenheira de software Bruna Leiras e pela Designer UI Luanda Pereira.

Em sua 2ª edição, o evento da comunidade PhpWomen vem trazendo oficinas e palestras com exercícios abordando a documentação do php.net, com uma didática multidisciplinar e metodologia de aprendizado colaborativo, se tornando um encontro de mulheres de tecnologia e desenvolvimento no Rio de Janeiro, onde mais iniciantes estão se interessando a aprender a programar e a estarem avançando em seus estudos.

Caso você tenha interesse em conhecer PHPWomen, é um movimento de mulheres na tecnologia pelo mundo. No Rio você pode acessar Meetup (https://www.meetup.com/pt-BR/topics/php-women/br/) ou participar pelos grupos do Telegram PHPRio, comunidade aberta de pessoas que trabalham com PHP.

Jigsaw - Gerador de sites estáticos em PHP

Daiane Alves — Sat, 07 Dec 2019 14:14:41 +0000

Introdução

Jigsaw é um framework baseado em Laravel que gera site estático em PHP. Foi desenvolvido pela empresa Tighten em maio de 2015, possui uma boa documentação e a comunidade é bem ativa.
Trata-se de uma aplicação que você pode utilizar em seu computador e que tem como saída os arquivos estáticos como: HTML, CSS e JavaScript.
Seu deploy pode ser feito em qualquer servidor web que provê conteúdo estático e se não quiser ter custos, pode publicar no GitHub Pages.

Iniciando um projeto

Para iniciar um projeto com Jigsaw é bem simples! Primeiro você deve abrir o terminal, criar uma pasta com o nome do seu projeto e em seguida acessar sua pasta. Para isso digite os seguintes comandos:

mkdir my-site && cd my-site

Instalando Jigsaw com Composer

Vamos utilizar o Composer (gerenciador de dependências do PHP) para fazer a instalação do Jigsaw no nosso projeto.

composer require tightenco/jigsaw

Inicializando o projeto

./vendor/bin/jigsaw init

Após iniciar o projeto você terá a seguinte estrutura de pastas:

Desenvolvimento - servidor local

Você pode acompanhar o desenvolvimento do site acessando o localhost:8000 após rodar o build e em seguida o serve.

Sempre que fizer alguma alteração e quiser acompanhar terá que rodar o build pois ele não carrega automaticamente as alterações.

./vendor/bin/jigsaw build

./vendor/bin/jigsaw serve

Compilando com Laravel Mix

Você também pode usar o Laravel para compilar e visualizar as alterações automaticamente utilizando o Browsersync. Para isso precisa instalar o NPM.

npm install

Depois disso digite o seguinte comando:

npm run watch

Desta maneira o Browsersync abrirá automaticamente uma nova guia do navegador e recarregará a página toda vez que você fizer uma alteração. Muito útil para visualizar suas alterações rapidamente!

Tipos de conteúdo

Todo o conteúdo do seu site deve ser armazenado na pasta source. O Jigsaw permite criar arquivos usando vários formatos, como:

Laravel's Blade
Markdown
Ou vários outros tipos de arquivo

Laravel's Blade

Também é possível criar sites usando Blade que é o sistemas de templates padrão do Laravel. Para isso, basta criar seus arquivos na pasta source como [nome_do_arquivo].blade.php
Você pode conferir como funciona o Blade na documentação oficial do Laravel.

Markdown

Para este tutorial, optei por mostrar como criar os arquivos usando Markdown.

Markdown é uma linguagem de marcação desenvolvida por John Gruber e Aaron Swartz. Ela é projetada para que textos simples possam ser convertidos em HTML e muitos outros formatos.

Com ela é possível marcar títulos, listas, tabelas, etc., de forma muito mais limpa, legível e precisa, do que se fosse fazer com HTML que é muito verboso.

Configurações do site

Uma maneira de agilizar o trabalho é definindo variáveis de configuração do site. Imaginem que, por exemplo, o e-mail esteja disponível em diversas partes do site e que por algum motivo você tenha que alterar. Você até poderia utilizar um find/replace, mas com o Jigsaw é muito simples. Basta adicionar o email no array do arquivo config.php que será acessível em todo projeto, como uma propriedade do objeto $page.

Por exemplo, se o seu config.php estiver assim:

<?php

return [
    'contact_email' => 'support@example.com',
];

Você pode usar essa variável em qualquer arquivo do site, assim:

@extends('_layouts.master')

@section('content')
    <p>Entre em contato {{ $page->contact_email }}</p>
@stop

Helpers

Além de armazenar variáveis no arquivo config.php, podemos definir helpers adicionando uma chave com o nome da função. Os helpers são chamados referenciando o nome do método no objeto $page em qualquer arquivo.

Por exemplo, você pode adicionar um método que identifica se a página atual pertence a uma seção específica, para realçar a seção atual em um menu:

Essa função é acessível chamando $page->selected("url-da-pagina") de qualquer página.

Veja o exemplo:

<?php

return [
    'company' => 'Lyseon Tech',
    'selected' => function ($page, $section) {
        return str_contains($page->getPath(), $section) ? 'selected' : '';
    },
];

Depois disso, dentro do diretório source, crie a pasta _partials (nela você pode dividir o seu site em partes como menu e footer). Agora, podemos criar um menu que destaque se uma página está selecionada, para isso crie o arquivo: _menu.blade.php e nele coloque o seguinte código:

<style>
.selected{
  font-weight: bold;
  color: red;
}
</style>

<a class="{{ $page->selected('about') }}"
    href="{{ $page->baseUrl }}/about">Sobre nós</a>
<a class="{{ $page->selected('projects') }}"
    href="{{ $page->baseUrl }}/projects">Projetos</a>
<a class="{{ $page->selected('posts') }}"
    href="{{ $page->baseUrl }}/blog">Blog</a>

Ps: Ignore o style junto com o html, usei apenas para exemplificar.
No arquivo _layouts/master.blade.php inclua o menu digitando @include('_partials._menu')
E por último, para que você consiga ver seu menu funcionando, é preciso criar um arquivo no diretório source, nesse exemplo criei o arquivo about (Sobre nós).
Prontinho! Se estiver usando o Browsersync você já consegue ver o menu funcionando no seu navegador.

Collections

O Jigsaw fornece recursos trabalhar com collections. As collections podem ser usadas para gerar páginas como por exemplo de postagens de blog ou artigos. Pode ser usada também para incorporar blocos de conteúdo de uma página, como biografias da equipe, descrições de produtos ou um portfólio de projetos.

Para criar uma collection é bem simples, crie uma chave chamada collections no array de configuração do arquivo config.php . Cada collection deve ser indicada pelo nome da collection (normalmente, no plural), seguido por um array de configurações.
Veja o exemplo a seguir:

<?php

return [
    'company' => 'Lyseon Tech',
    'contact_email' => 'support@tighten.co',
    'collections' => [
        'posts' => [
            'path' => 'blog/{date|Y-m-d}/{filename}',
            'author' => 'Daiane',
        ],
    ],
];

Layout das páginas de post

Crie o arquivo post.blade.php dentro da pasta _layouts e chamar as variáveis que foram definidas no seu arquivo config.php

@extends('_layouts.master')

@section('body')
    <h1>{{ $page->title }}</h1>
    <p>By {{ $page->author }} • {{ date('F j, Y', $page->date) }}</p>

    @yield('content')

    <p>Total de {{ $posts->count() }} posts</p>

    <p>Listagem:</p>
    <ul>
    @foreach ($posts as $post)
        <li>
          <a class="{{ $page->selected($post->_meta->url[0]) }}" href="{{$post->_meta->url[0]}}">{{ $post->title }}</a>
        </li>
    @endforeach
    </ul>

@endsection

Pasta para armazenar os posts

Crie a pasta _post dentro da pasta source

Criando um item em uma Collection

Na pasta pasta _post criaremos nosso primeiro post em markdown para isso crie um arquivo [nome_do_arquivo].md seguindo o modelo abaixo:

---
extends: _layouts.post
title: "Meu primeiro Post"
author: Daiane
date: 2017-03-23
section: content
---

Jigsaw é um poderoso gerador de **site estático** em PHP!

Sumário da collection `posts`

Para termos um sumário de posts em ´/blog´, crie na raiz da pasta source o arquivo blog.blade.php conforme a raiz do path informado na collection posts no arquivo de configuração do site.

@extends('_layouts.master')
@section('body')
<ul>
  @foreach ($posts as $post)
    <li><a href="{{$post->_meta->url[0]}}">{{ $post->title }}</a></li>
  @endforeach
</ul>
<h1>Listagem de posts</h1>
@endsection

E assim temos nosso site utilizando Jigsaw.

Veja também:

Se quiser conferir esse projeto no meu GitHub

Forem: PHPWomenBR

Manipulação de arquivos csv no PHP

Manipulação de arquivos csv com PHP

O que é csv?

Abrindo um arquivo csv existente

Criando um arquivo csv

Inserindo dados no arquivo csv

Sintaxe

Parâmetros

Criando cabeçalho

Manipulando os dados

Organizando preços em ordem decrescente

Lendo um arquivo csv existente

MeetJitsi - Ferramenta Open Source para vídeo conferência

Conhecendo a interface

Por mais mulheres na tecnologia: Grupo de incentivo PHPWomen-BR

Jigsaw - Gerador de sites estáticos em PHP

Introdução

Iniciando um projeto

Instalando Jigsaw com Composer

Inicializando o projeto

Desenvolvimento - servidor local

Compilando com Laravel Mix

Tipos de conteúdo

Laravel's Blade

Markdown

Configurações do site

Helpers

Collections

Layout das páginas de post

Pasta para armazenar os posts

Criando um item em uma Collection

Sumário da collection posts

Veja também:

Manipulação de arquivos `csv` com PHP

O que é `csv`?

Abrindo um arquivo `csv` existente

Criando um arquivo `csv`

Inserindo dados no arquivo `csv`

Lendo um arquivo `csv` existente

Sumário da collection `posts`