Solución de Problemas

​

Descripción del Error

Error de conexión: Connection refused (2002)

​

Causa

​

Solución

1. Abre el Panel de Control de XAMPP
2. Verifica el estado del módulo MySQL
3. Haz clic en Start junto a MySQL
4. Espera a que el estado cambie a verde con el texto “Running”

​

Verificar Puerto 3306

netstat -ano | findstr :3306

sudo netstat -tulpn | grep :3306

1. Clic en Config (MySQL) > my.ini
2. Buscar port=3306 y cambiar a port=3307
3. Actualizar config/conexion.php:

$conn = new mysqli("localhost:3307", $user, $pass, $db);

​

Descripción del Error

Error de conexión: Access denied for user 'root'@'localhost' (using password: YES)

​

Causa

​

Solución

1. Verifica las credenciales actuales de MySQL en phpMyAdmin
2. Edita /workspace/source/config/conexion.php:

<?php
$host = "localhost";
$user = "root";        // Verificar usuario correcto
$pass = "";            // Agregar contraseña si existe
$db   = "bd_inventario";

$conn = new mysqli($host, $user, $pass, $db);

if ($conn->connect_error) {
    die("Error de conexión: " . $conn->connect_error);
}
?>

​

Restablecer Contraseña de MySQL

1. Detén MySQL desde el panel de XAMPP
2. Haz clic en Config > my.ini
3. Agrega bajo [mysqld]:
   skip-grant-tables
   
4. Inicia MySQL nuevamente
5. Abre phpMyAdmin y ejecuta:
   UPDATE mysql.user SET Password=PASSWORD('') WHERE User='root';
   FLUSH PRIVILEGES;
   
6. Elimina skip-grant-tables de my.ini
7. Reinicia MySQL

​

Descripción del Error

Error de conexión: Unknown database 'bd_inventario'

​

Causa

​

Solución

1. Abre phpMyAdmin en http://localhost/phpmyadmin
2. Haz clic en Nueva en el panel izquierdo
3. Nombre de la base de datos: bd_inventario
4. Cotejamiento: utf8mb4_general_ci
5. Haz clic en Crear

​

Crear Tablas Manualmente

-- Tabla de usuarios
CREATE TABLE usuarios (
  id INT AUTO_INCREMENT PRIMARY KEY,
  nombre VARCHAR(100) NOT NULL,
  correo VARCHAR(100) UNIQUE NOT NULL,
  contraseña VARCHAR(255) NOT NULL,
  rol ENUM('Admin', 'Empleado') DEFAULT 'Empleado',
  fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- Tabla de productos
CREATE TABLE productos (
  id INT AUTO_INCREMENT PRIMARY KEY,
  nombre VARCHAR(150) NOT NULL,
  codigo VARCHAR(50) UNIQUE NOT NULL,
  precio DECIMAL(10,2) NOT NULL DEFAULT 0.00,
  stock INT NOT NULL DEFAULT 0,
  fecha_creacion TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- Tabla de movimientos
CREATE TABLE movimientos (
  id INT AUTO_INCREMENT PRIMARY KEY,
  producto_id INT NOT NULL,
  tipo ENUM('entrada', 'salida') NOT NULL,
  cantidad INT NOT NULL,
  fecha TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (producto_id) REFERENCES productos(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- Insertar usuario administrador de prueba
INSERT INTO usuarios (nombre, correo, contraseña, rol) 
VALUES ('Administrador', '[email protected]', 'admin123', 'Admin');

​

Descripción

​

Causa

​

Solución

1. Abre phpMyAdmin: http://localhost/phpmyadmin
2. Selecciona la base de datos bd_inventario
3. Haz clic en la tabla usuarios
4. Pestaña Insertar
5. Agrega un usuario de prueba:

6. Haz clic en Continuar

• Correo: [email protected]
• Contraseña: admin123

​

Descripción

​

Causa

​

Solución

1. Abre phpMyAdmin
2. Navega a bd_inventario > usuarios
3. Haz clic en Examinar
4. Localiza tu usuario y haz clic en Editar
5. Actualiza el campo contraseña con una nueva contraseña sin espacios
6. Guarda los cambios

​

Implementar Hashing Seguro (Recomendado)

if ($password == $usuario['contraseña']) {

if (password_verify($password, $usuario['contraseña'])) {

$hash = password_hash($password, PASSWORD_DEFAULT);

​

Descripción

​

Causa

​

Solución

session.gc_maxlifetime = 3600    ; Sesión dura 1 hora
session.cookie_lifetime = 3600   ; Cookie dura 1 hora

​

Descripción

​

Causa

​

Solución

1. Verifica que session_start() esté al inicio de cada archivo PHP
2. Comprueba que no haya salida antes de session_start()
3. Verifica la configuración de sesiones en php.ini:

session.save_handler = files
session.save_path = "C:/xampp/tmp"  ; Windows
; session.save_path = "/tmp"        ; Linux

4. Asegúrate de que la carpeta de sesiones tenga permisos de escritura

dir C:\xampp\tmp

ls -la /tmp
sudo chmod 1777 /tmp

5. Limpia las cookies del navegador y vuelve a intentar

​

Descripción del Error

Error: Apache shutdown unexpectedly.
Port 80 in use by "Unable to open process" with PID 4!

​

Causa

​

Solución 1: Identificar el Proceso

netstat -ano | findstr :80

​

Solución 2: Cambiar Puerto de Apache

1. En el panel de XAMPP, haz clic en Config (Apache) > httpd.conf
2. Busca la línea:
   Listen 80
   
3. Cámbiala por:
   Listen 8080
   
4. Busca también:
   ServerName localhost:80
   
5. Cámbiala por:
   ServerName localhost:8080
   
6. Guarda el archivo y reinicia Apache
7. Accede al sistema usando: http://localhost:8080/inventario

​

Descripción

​

Causa

​

Solución 1: Verificar Permisos

1. Clic derecho en C:\xampp\htdocs
2. Propiedades > Seguridad
3. Asegurar que “Usuarios” tengan permisos de Lectura y Ejecución

sudo chmod -R 755 /opt/lampp/htdocs
sudo chown -R daemon:daemon /opt/lampp/htdocs

​

Solución 2: Verificar Configuración de Apache

<Directory "/opt/lampp/htdocs">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted  # Asegúrate de que diga 'granted'
</Directory>

​

Descripción

​

Causa

​

Solución

display_errors = On
error_reporting = E_ALL
log_errors = On
error_log = "C:/xampp/php/logs/php_error_log"  ; Windows
; error_log = "/opt/lampp/logs/php_error_log"  ; Linux

​

Descripción del Error

Warning: Cannot modify header information - headers already sent by...

​

Causa

​

Solución

1. Verifica que NO haya espacios antes de <?php en los archivos
2. Asegúrate de que no haya ?> al final de archivos PHP puros
3. Guarda los archivos con codificación UTF-8 sin BOM

<?php  // ← Espacio/línea en blanco ANTES de <?php
session_start();

<?php  // ← Sin espacios antes
session_start();

​

En Visual Studio Code:

1. Abre el archivo con el error
2. Clic en la esquina inferior derecha donde dice “UTF-8”
3. Selecciona “Save with Encoding”
4. Elige “UTF-8” (sin BOM)

​

Descripción

​

Causa

​

Solución

1. Verifica que los servicios Apache y MySQL estén activos
2. Revisa los errores en el navegador (F12 > Consola)
3. Verifica el log de errores de PHP:

4. Prueba la conexión directamente:

<?php
include("config/conexion.php");

if ($conn->ping()) {
    echo "Conexión exitosa";
} else {
    echo "Error: " . $conn->error;
}
?>

5. Verifica que la tabla productos existe:

SHOW TABLES LIKE 'productos';

​

Causa

​

Solución

1. Incrementa memoria de PHP en php.ini:
   memory_limit = 256M
   max_execution_time = 300
   
2. Optimiza MySQL editando my.ini:
   [mysqld]
   innodb_buffer_pool_size = 256M
   key_buffer_size = 128M
   max_connections = 100
   
3. Agrega índices a las tablas:
   -- En phpMyAdmin > SQL
   ALTER TABLE productos ADD INDEX idx_codigo (codigo);
   ALTER TABLE movimientos ADD INDEX idx_producto (producto_id);
   ALTER TABLE movimientos ADD INDEX idx_fecha (fecha);
   
4. Reinicia Apache y MySQL después de los cambios.

​

Causa

​

Solución

$cfg['MaxRows'] = 50;  // Reducir filas mostradas
$cfg['RowActionLinksWithoutUnique'] = true;
$cfg['ExecTimeLimit'] = 300;