Skip to content

Manual Técnico appServiserAdmin

Documentación Técnica del Archivo upload.php en la Carpeta

appServiserAdmin/web/ckeditor


Español

¿Para qué es?

El archivo upload.php es un script de PHP que maneja la carga de imágenes para CKEditor 5 en la aplicación ServiserAdmin. Gestiona el proceso de subida, validación y almacenamiento de imágenes.

Definición de la Carpeta

Ubicación: appServiserAdmin/web/ckeditor/upload.php Contexto: Se encuentra en la carpeta CKEditor, actuando como endpoint para la carga de imágenes del editor.

Propósito

  • Manejar las solicitudes de carga de imágenes
  • Validar los archivos subidos
  • Almacenar las imágenes en el servidor
  • Proporcionar respuestas JSON al editor
  • Gestionar errores de carga

Funciones Principales

  1. Configuración de Directorio
$targetDir = "images/";
if (!is_dir($targetDir)) {
mkdir($targetDir, 0777, true);
}
  1. Validación de Imágenes
$check = getimagesize($_FILES["upload"]["tmp_name"]);
if ($check !== false) {
// Procesamiento de imagen válida
}
  1. Manejo de Respuestas
// Éxito
echo json_encode(["url" => "http://localhost/sennova/appServiserAdmin/web/ckeditor/" . $targetFile]);
// Error
http_response_code(400);
echo json_encode(["error" => "El archivo no es una imagen válida."]);

Consideraciones de Seguridad

  1. Validación de tipo de archivo
  2. Permisos de directorio apropiados
  3. Manejo de errores robusto
  4. Respuestas HTTP adecuadas
  5. Validación de tamaño de imagen

English

Technical Documentation - upload.php File

What is it for?

The upload.php file is a PHP script that handles image uploads for CKEditor 5 in the ServiserAdmin application. It manages the upload process, validation, and storage of images.

Folder Definition

Location: appServiserAdmin/web/ckeditor/upload.php Context: Located in the CKEditor folder, serving as an endpoint for editor image uploads.

Purpose

  • Handle image upload requests
  • Validate uploaded files
  • Store images on the server
  • Provide JSON responses to the editor
  • Manage upload errors

Main Functions

  1. Directory Configuration
$targetDir = "images/";
if (!is_dir($targetDir)) {
mkdir($targetDir, 0777, true);
}
  1. Image Validation
$check = getimagesize($_FILES["upload"]["tmp_name"]);
if ($check !== false) {
// Valid image processing
}
  1. Response Handling
// Success
echo json_encode(["url" => "http://localhost/sennova/appServiserAdmin/web/ckeditor/" . $targetFile]);
// Error
http_response_code(400);
echo json_encode(["error" => "File is not a valid image."]);

Additional Notes

  • Includes commented version for Yii2 integration
  • Implements file type validation
  • Handles HTTP status codes
  • Provides JSON format responses
  • Creates directories automatically if they don’t exist