Saltar a contenido

PiecesPHP Framework

Configuración de entorno

  • Requerimientos
    • PiecesPHP
    • Composer
    • NodeJS 22.x LTS con FNM
    • NPM
    • Gulp CLI

Actualizar repositorios

sudo apt update && sudo apt upgrade -y

Instalación de dependencias de desarrollo

Composer

  • Mediante apt: 
    #Instalar
sudo apt install composer -y
sudo apt install composer
#Verificar versión
composer --version
  • Mediante descarga: 
    php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

NodeJS (v22.12.0) y NPM

#Instalar FNM
cd ~
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc
#Instalar Node
fnm install 22.12.0
fnm use 22.12.0
#Verificar versiones
node --version
npm --version
## Aplicar medidas de seguridad a entorno Node
npm config set ignore-scripts true --global
npm config get ignore-scripts

Gulp CLI y Typescript

sudo npm install -g gulp-cli typescript
gulp --version
tsc --version

Desplegar PiecesPHP

Paso 1: Definir variables útiles

#Variable con la carpeta del proyecto, si no existe debe crearse antes
export FOLDER="/var/www/html/pcsphp_project"
mkdir -p $FOLDER

O, en caso de que se quiera hacer en el directorio actual (donde está abierta la terminal):

export FOLDER=$(pwd)

Paso 2: Descargar y descomprimir

cd $FOLDER
wget https://github.com/vmorantes/piecesphp/archive/refs/heads/last-stable.zip
unzip last-stable.zip -d . && rm last-stable.zip

Paso 3: Mover a la raíz, eliminar archivos innecesarios y ajustar permisos

Nota: En la eliminación se obtendrá una advertencia por los meta archivos . y .., no es importante.

Mover
find . -depth -type d -name * -execdir mv {} tmp \;
sudo mv ./tmp/{*,.*} ./;
Eliminar y Ajustar Permisos
sudo rm -Rf tmp CHANGELOG.md README.md TODO TODO.md guides source-docs src/adminer LICENSE;
# Ejecuta la utilidad de ajuste de permisos y propiedad
chmod +x permissions-and-property.sh;
./permissions-and-property.sh;

[!IMPORTANT] Permisos: Para información sobre permisos ver la Guía de Permisos y Propiedad.

Paso 4: Composer y Gulp

#Instalar gulp para desarrollo
cd $FOLDER
rm -Rf node_modules package-lock* ##Si hay algún proyecto NPM desplegado ya
npm cache clean --force ##Para actualizar los repositorios
npm install ##NO USAR sudo

#Instalar paquetes de composer
cd $FOLDER/src
composer install ##NO USAR sudo
Actualización de NPM (solo en caso de errores)
#Para actualizar dependencias
npm install -g npm-check-updates
ncu -u
npm install

Paso 5: Activación de módulos apache necesarios

sudo a2enmod rewrite headers ssl
sudo systemctl restart apache2

Más información

  • Durante el desarrollo se recomiendo el uso de las siguientes tareas de gulp (para más información, clic aquí):
    • init-project
    • init-project:watch
  • Base de datos:
    • Se debe configurar la conexión en el archivo src/app/database.php
    • Los archivos para usar en la base de datos están en la carpeta databases
  • Otras cosas:
    • En el archivo src/app/constants.php se pueden activar/desactivar algunas características integradas.

Despliegue de PiecesPHP (Ubuntu 24.04 LTS)

Notas adicionales

  • Configura la base de datos en src/app/database.php.
  • Los archivos SQL están en la carpeta databases.
  • Puedes activar/desactivar características en src/app/constants.php.