Mis apuntes · Aprende Go desde PHP

Se guardan solos en este navegador mientras escribes. Puedes usar Markdown. Al descargarlos, la primera línea es tu enlace personal al curso.

Lección 26 de 36 · Un proyecto real ✦ WebMCP implementado

El ecosistema de Go

7 min de lectura Lección de lectura

Ya sabes montar un proyecto, probarlo y servirlo por la web. Esta lección es un mapa: las herramientas que usarás cada día, lo que trae Go de serie, las librerías más populares con su equivalente en PHP y dónde seguir aprendiendo. Sin retos: léela con calma y guárdala en favoritos.

¿De dónde vienen los nombres?

gopls = Go please (Go, por favor: así se pronuncia)
El servidor de lenguaje oficial: da autocompletado, errores en rojo y «ir a la definición» a VS Code, GoLand o Vim. Tu Intelephense.
vet = to vet (revisar a fondo)
go vet revisa el código buscando errores que compilan pero están mal. Un PHPStan pequeñito que viene de serie.
dlv = Delve (indagar, hurgar)
El depurador de Go: puntos de ruptura y paso a paso. Tu Xdebug.
slog = structured log (log estructurado)
El paquete de logs con campos (clave y valor) de la biblioteca estándar. Tu Monolog.
govulncheck = Go + vulnerability + check
Busca en tus dependencias fallos de seguridad conocidos, y solo avisa de los que tu código llega a usar. Tu composer audit.
En 4 ideas
1/4

Go trae de serie formato (go fmt), revisión (go vet), tests y documentación. En PHP los instalas aparte: PHP-CS-Fixer, PHPStan, PHPUnit y phpDocumentor.

1 · Las herramientas de cada día

En un proyecto PHP serio sueles tener un composer.json lleno de herramientas de desarrollo. En Go muchas vienen con el propio go, y las demás se instalan con una orden. Piensa en una caja de herramientas que ya trae martillo y destornillador al comprarla.

Herramienta GoPara quéEn PHP
go fmt (de serie)Formatea el código con el estilo oficialPHP-CS-Fixer
go vet (de serie)Errores que compilan pero están malPHPStan en un nivel bajo
go doc (de serie)Documentación en la terminalphpDocumentor
goplsAutocompletado y errores en el editorIntelephense
staticcheckAnálisis estático más profundoPHPStan o Psalm en nivel alto
golangci-lintEjecuta muchos linters de una vezGrumPHP con varias herramientas
Delve (dlv)Depurador paso a pasoXdebug
govulncheckVulnerabilidades en dependenciascomposer audit

Un ejemplo de lo que caza go vet. Este programa compila y se ejecuta, pero algo sale mal. Pulsa Ejecutar:

Gomain.go
package main

import "fmt"

func main() {
    pendientes := "3"
    // Compila y se ejecuta, pero %d espera un número.
    fmt.Printf("Tienes %d tareas pendientes\n", pendientes)
}

Ese %!d(string=3) es la forma que tiene fmt de decirte que el verbo no cuadra con el valor. En PHP, printf("%d", "tres") imprime un 0 sin avisar y nadie se entera. go vet lo encuentra sin ejecutar nada:

$ go vet main.go
main.go:8:24: fmt.Printf format %d has arg pendientes of wrong type string

Desde Go 1.24 puedes fijar las herramientas del proyecto en go.mod, como las require-dev de Composer, y ejecutarlas con go tool:

$ go get -tool honnef.co/go/tools/cmd/staticcheck
$ go tool staticcheck ./...

$ go install golang.org/x/vuln/cmd/govulncheck@latest
$ govulncheck ./...
No vulnerabilities found.

¿Por qué? · En PHP no existe

¿Por qué go fmt no te deja elegir el estilo? En PHP cada equipo tiene el suyo

En PHP hay PSR-12, PER, el estilo de Symfony, el de Laravel… y en cada equipo alguien discute si la llave va en su línea o no. Son horas perdidas y revisiones de código llenas de espacios.

Go zanjó la discusión el primer día: hay un formato y lo aplica go fmt. Uno de los Go Proverbs (refranes de Go) lo resume: «el estilo de gofmt no es el favorito de nadie, pero gofmt es el favorito de todos». Todo el código Go del mundo se lee igual, y las revisiones hablan de lo que importa.

2 · La biblioteca estándar: lo que no tienes que instalar

Este es el gran cambio de mentalidad. En PHP, para logs instalas Monolog; para peticiones HTTP, Guzzle; para plantillas, Twig. En Go, mucho de eso ya viene dentro:

Necesito…En PHP (Composer)En Go (de serie)
Servidor web y routernginx + php-fpm + Slimnet/http
Cliente HTTPGuzzlenet/http (http.Get, http.Client)
Logs con camposMonologlog/slog
Plantillas HTML que escapanTwightml/template
Base de datosPDO (de serie)database/sql + un driver
JSONjson_encode() (de serie)encoding/json
TestsPHPUnittesting
FechasCarbontime
Hasheshash('sha256', …) (de serie)crypto/sha256
PHP 8.5log.php
<?php
declare(strict_types=1);

// composer require monolog/monolog
use Monolog\Formatter\JsonFormatter;
use Monolog\Handler\StreamHandler;
use Monolog\Logger;

$salida = new StreamHandler("php://stdout");
$salida->setFormatter(new JsonFormatter());

$log = new Logger("tareas");
$log->pushHandler($salida);

$log->info("tarea creada", ["id" => 7, "titulo" => "Comprar pan"]);
$log->warning("tarea vencida", ["id" => 3]);
Gomain.go
package main

import (
    "log/slog"
    "os"
)

func main() {
    // Sin composer require: log/slog viene con Go.
    log := slog.New(slog.NewJSONHandler(os.Stdout, nil))

    // En PHP: $log->info("tarea creada", ["id" => 7, ...]);
    log.Info("tarea creada", "id", 7, "titulo", "Comprar pan")
    log.Warn("tarea vencida", "id", 3)
}

Otro ejemplo: html/template escapa solo lo que pintas, igual que Twig con su autoescape. Un título con HTML malicioso sale inofensivo:

Gomain.go
package main

import (
    "html/template"
    "os"
)

type Tarea struct {
    Titulo string
    Hecha  bool
}

// {{range}} es tu {% for %} de Twig y {{.Titulo}} tu {{ tarea.titulo }}.
const pagina = `<ul>
{{range .}}  <li>{{if .Hecha}}✔{{else}}·{{end}} {{.Titulo}}</li>
{{end}}</ul>
`

func main() {
    tareas := []Tarea{
        {Titulo: "Comprar pan", Hecha: true},
        {Titulo: "<script>alert('hola')</script>"},
    }
    plantilla := template.Must(template.New("tareas").Parse(pagina))
    // En PHP: echo $twig->render('tareas.html.twig', ['tareas' => $tareas]);
    plantilla.Execute(os.Stdout, tareas)
}

¿Por qué? · En PHP no existe

¿Por qué Go prefiere la biblioteca estándar a las dependencias? En PHP lo normal es Composer

Cada dependencia es código de otra persona que entra en tu programa: puede tener fallos, dejar de mantenerse o, en el peor caso, ser manipulada (lo que se llama un ataque a la cadena de suministro). En PHP es normal tener cientos de paquetes en vendor/ sin saber qué hace la mitad.

Go lo afronta de dos formas:

  • Una biblioteca estándar grande y estable: la promesa de compatibilidad de Go 1 asegura que el código escrito para Go 1.0 (2012) sigue compilando hoy. No hay un «PHP 7 → 8» que te rompa el proyecto.
  • Una cultura de pocas dependencias: otro Go Proverb dice «un poco de copia es mejor que una pequeña dependencia». Si solo necesitas una función, escríbela; no traigas una librería entera.

3 · Librerías populares y su equivalente PHP

Para lo que la biblioteca estándar no cubre (o cubre a medias), estas son las más usadas. Todas se añaden con go get y se buscan en pkg.go.dev:

Para…Librería GoSe parece a (PHP)
Router ligerochiSlim
Framework webGin o EchoLumen, Slim con middlewares
SQL a código tipadosqlcNo hay equivalente directo: escribes SQL y genera funciones Go
ORMGORMEloquent o Doctrine ORM
PostgreSQLpgxpdo_pgsql
Migracionesgolang-migrateDoctrine Migrations o Phinx
Asserts y mockstestifyLos asserts de PHPUnit y Mockery
Comandos de consolacobraSymfony Console o Artisan
Configuraciónviperphpdotenv + los config/*.php
ValidaciónvalidatorSymfony Validator

4 · Dónde seguir aprendiendo

La documentación oficial de Go es muy buena y está pensada para leerse de principio a fin. Por orden, de lo más fácil a lo más profundo:

  1. Tour of Go: el tutorial interactivo oficial, en el navegador.
  2. Go by Example: un ejemplo corto y ejecutable por cada tema. Perfecto como chuleta.
  3. Learn Go with Tests: aprende Go escribiendo primero el test, con una parte entera sobre servidores web.
  4. Effective Go: cómo escribir Go «a lo Go». Léelo cuando ya te muevas con soltura.
  5. Documentación oficial: guías de módulos, tests, bases de datos y más.
  6. El blog de Go: cada novedad del lenguaje, explicada por quien la hizo.
  7. Go Proverbs: los refranes de Go que has visto en esta lección, con su charla original.
  8. Awesome Go: lista enorme de librerías por categoría, para cuando busques algo concreto.

La pregunta que te vas a hacer

«Vale, pero… ¿y qué uso para mi próxima API, como haría con Laravel o Symfony?»

Empieza sin framework: net/http con los patrones de Go 1.22, encoding/json y database/sql, justo lo de la lección anterior. Te sobra para una API pequeña o mediana y no dependes de nadie.

Cuando eches de menos algo concreto, añade solo esa pieza:

Resumen

Lo que te llevas de esta lección

  1. go fmt, go vet, go test y go doc vienen de serie (en PHP, PHP-CS-Fixer, PHPStan, PHPUnit y phpDocumentor).
  2. gopls en el editor, dlv para depurar y govulncheck para seguridad (en PHP, Intelephense, Xdebug y composer audit).
  3. Antes de un go get, mira la biblioteca estándar: net/http, log/slog, html/template, database/sql (en PHP, Slim, Monolog, Twig y PDO).
  4. chi ≈ Slim, GORM ≈ Eloquent, cobra ≈ Symfony Console, testify ≈ asserts de PHPUnit.
  5. Para seguir: Tour of Go, Go by Example y Learn Go with Tests.

Para recordarlo: «Primero la caja, luego la tienda»

Antes de comprar una herramienta (una librería), abre la caja que ya tienes (la biblioteca estándar). Solo si de verdad no está, ve a la tienda (go get).