Visual Studio Code. Perfil recomendado para el curso Programación web en PHP

Importar el perfil recomendado

La URL del perfil recomendado para seguir estos apuntes es: https://gist.github.com/BartolomeSintes/b2ad1d8c4e87bf8015c5c136a095134f (actualizado el 24 de septiembre de 2026).

Una vez importado este perfil en Visual Studio Code, se requieren un par de ajustes adicionales que se comentan en los apartados siguientes.

Para importar el perfil de Visual Studio Code recomendado para este curso ...

• Haga clic en la rueda dentada situada abajo a la izquierda y elija la opción Perfiles:

  

• Se abrirá la pestaña o la ventana de administración de los perfiles (con el título Perfiles):

  

• Haga clic en el triángulo situado a la derecha en el botón "Nuevo perfil" y elija la opción Importar perfil ...:

  

• Se abrirá una caja de texto para escribir la URL del perfil compartido:

  

• Copie la URL del perfil recomendado para seguir estos apuntes: https://gist.github.com/BartolomeSintes/b2ad1d8c4e87bf8015c5c136a095134f (actualizado el 24 de septiembre de 2026).
• Copie y pegue el enlace en la caja de texto y pulse Intro:

  

• Se mostrará el nuevo perfil en la lista de perfiles de la izquierda y la información sobre el contenido del perfil en la parte derecha de la ventana:

  

• El nombre del perfil se mostrará en una caja de texto:

  

• Ese nombre se puede cambiar, por ejemplo, por un nombre más corto. Es aconsejable que el nombre de cada perfil empiece de forma distinta (el motivo se explica en el apartado siguiente, al seleccionar el perfil). Para terminar, haga clic en el botón "Crear".

  

• Si el perfil contiene referencias a extensiones a las que nunca se ha dado permiso sde mostrará un aviso para hacerlo. Haga clic en el botón "Confiar en publicadores e instalar" para instalar las extensiones incluidas en el perfil.

  

• El perfil creado se mostrará en la lista de perfiles del lado izquierdo. Los detalles del perfil se muestran en el lado derecho. Fíjese en que al crear un perfil éste no se selecciona automáticamente (en la captura, el perfil activo sigue siendo el perfil predeterminado).

  

Una vez importado este perfil en Visual Studio Code, se requieren un par de ajustes adicionales que se comentan en los apartados siguientes. Aunque uno de los ajustes no requiere haber seleccionado una carpeta o área de trabajo, el otro sí lo requiere, por lo que se recomienda seleccionar una carpeta o un área de trabajo antes de completar la configuración del perfil.

Área de trabajo

En este curso Iniciación a la programación de páginas web en PHP de mclibre.org se utilizará una carpeta como área de trabajo de Visual Studio Code (no un Área de trabajo).

1. Con el Explorador de archivos de Windows, cree la carpeta Documentos > IAW > PHP (el nombre de esta carpeta puede contener mayúsculas):

   

2. Cree la carpeta Documentos > IAW > PHP > ejercicios y la carpeta Documentos > IAW > PHP > pruebas (se recomienda que los nombres de estas carpetas no contengan mayúsculas):

   

3. En Visual Studio Code, elija la opción de menú Archivo > Abrir carpeta ...:

   

4. Seleccione la carpeta Documentos > IAW > PHP:

   

5. Desde la versión 1.57 (mayo 2021) Visual Studio Code incluye un administrador de confianza (Workspace Trust). Visual Studio Code sólo ejecutará archivos cuando se haya indicado que se confía en ellos. La primera vez que se abre una carpeta, Visual Studio Code pregunta si se confía en el contenido de esa carpeta. Haga clic en "Administrar" o en "Modo restringido":

   

6. Se muestra una ventana en la que se indica el modo actual (restringido). Para indicar que confía en la carpeta, haga clic en "Confiar":

   

7. La ventana indicará el cambio del modo. Cierre la ventana para empezar a trabajar en la carpeta:

   

8. Haga clic en el icono Explorador en la barra de actividades para ver el contenido de la carpeta elegida. El nombre de la carpeta se mostrará en la parte superior derecha de la barra de actividades:

   

Seleccionar el perfil recomendado

Para seleccionar el perfil de Visual Studio Code recomendado para este curso ...

• Haga clic en la rueda dentada y elija la opción Perfil. (en la opción Perfil se muestra entre paréntesis el nombre del perfil actualmente seleccionado, que en este caso es el perfil Predeterminado). Se mostrará la lista de pefiles disponible, con una marca en el perfil actualmente seleccionado:

  

• Haga clic en el nombre de perfil que desee seleccionar:

  

• Inmediatamente se activará el perfil que puede modificar algunos elementos del interfaz. En la rueda dentada se muestran las dos primeras letras del nombre del perfil seleccionado (PH en este caso), salvo que el perfil tenga un icono asociado en cuyo caso la rueda dentada se sustituirá por el icono. Esto permite en cualquier momento comprobar el perfil seleccionado.

  

• Si hubiera ambigüedad porque varios perfiles comenzaran por las mismas dos letras, haciendo clic en la rueda dentada, el menú muestra el nombre completo del perfil seleccionado, lo que permite asegurarse de cuál es el perfil seleccionado.

  

• La selección del perfil debe repetirse cada vez que abra por primera vez una carpeta o un área de trabajo. VSCode recuerda la selección.
• Para completar la configuración de un perfil, como se comenta en los apartados siguientes, es necesario activar el perfil correspondiente.

Configuración

Por motivos de seguridad, al exportar un perfil VSCode no incluye las referencias a rutas de archivos que aparezcan en el archivo de preferencias. En el caso del perfil recomendado para seguir estos apuntes, la preferencia que indica la ruta al ejecutable del intérprete de PHP está incluida, pero comentada, por lo que se necesita descomentarla.

• En caso de no estar configurada la ruta de acceso al ejetutable de PHP, al abrir cualquier programa PHP VSCode mostraría el siguiente aviso::

  

• Para editar el archivo de configuración, haga clic en la rueda dentada y elija la opción Configuración:

  

• Se abrirá una pestaña con las preferencias de configuración. Haga clic en el icono situado arriba a la derecha que permite abrir el archivo settings.json del perfil:

  

• Se abrirá una nueva pestaña mostrando el nombre del fichero, su ubicación en el disco y el contenido.:

  

• Busque la preferencia "php.validate.executablePath" en el archivo de preferencias (al comienzo del archivo se indica la línea en la que se encuentra esta preferencia)...

  ...
    //
    // PHP: Validate: Executable path
    // Ubicación del intérprete de PHP.
    // "php.validate.executablePath": "C:/xampp/php/php.exe",
  ...
  

• ... y descomente la línea (la ruta debe indicar la ubicación del intérprete de PHP en su ordenador):

  ...
    //
    // PHP: Validate: Executable path
    // Ubicación del intérprete de PHP.
    "php.validate.executablePath": "C:/xampp/php/php.exe",
  ...
  

• Guarde el archivo y cierre las pestañas abiertas.

Archivo de configuración de PHP CS Fixer

Por motivos de seguridad, al exportar un perfil VSCode no incluye archivos adicionales a los propios de Visual Studio Code. En el caso del perfil recomendado para seguir estos apuntes, el archivo de configuración de la extensión PHP CS Fixer no está incluido en el perfil, por lo que es necesario crearlo manualmente.

Este archivo debe crearse en la carpeta .vscode situada la raíz de la carpeta de trabajo. En caso de no existir esa carpeta, debe crearse. Tanto la carpeta como el archivo deben crearse en cada carpeta de trabajo que se utilice.

• Para crear el archivo de configuración de la extensión PHP CS Fixer, abra la carpeta del área de trabajo

  

• Cree la carpeta .vscode en la carpeta raíz de la carpeta de trabajo (con el Explorador de archivos de Windows o con el propio Visual Studio Code).

  

• Cree el fichero php-cs-fixer-config.php en la carpeta .vscode (con el Explorador de archivos de Windows o con el propio Visual Studio Code).

  

• Copie en este fichero la configuración recomendada para PHP CS Fixer que se muestra a continuación.

  <?php
  
  // Apuntes del curso Programación web en PHP
  // https://www.mclibre.org/consultar/php/
  //
  // Archivo de configuración para PHP CS Fixer
  // 2025-10-19
  
  return (new PhpCsFixer\Config())
      ->setRules([
          '@PER-CS' => true,
          'align_multiline_comment' => ['comment_type' => 'all_multiline'],
          'binary_operator_spaces' => ['default' => 'single_space', 'operators' => ['=' => 'align_single_space_minimal']],
          'combine_consecutive_issets' => true,
          'explicit_indirect_variable' => true,
          'include' => true,
          'linebreak_after_opening_tag' => true,
          'list_syntax' => ['syntax' => 'short'],
          'magic_constant_casing' => true,
          'magic_method_casing' => true,
          'multiline_comment_opening_closing' => true,
          'multiline_whitespace_before_semicolons' => true,
          'native_function_casing' => true,
          'native_type_declaration_casing' => true,
          'no_alias_language_construct_call' => true,
          'no_alternative_syntax' => true,
          'no_empty_statement' => true,
          'no_extra_blank_lines' => true,
          'no_mixed_echo_print' => ['use' => 'print'],
          'no_multiline_whitespace_around_double_arrow' => true,
          'no_short_bool_cast' => true,
          'no_singleline_whitespace_before_semicolons' => true,
          'no_spaces_around_offset' => true,
          'no_unneeded_braces' => true,
          'no_unneeded_control_parentheses' => true,
          'no_unset_cast' => true,
          'no_unused_imports' => true,
          'no_useless_concat_operator' => true,
          'no_useless_return' => true,
          'no_whitespace_before_comma_in_array' => true,
          'normalize_index_brace' => true,
          'object_operator_without_whitespace' => true,
          'semicolon_after_instruction' => true,
          'single_line_comment_style' => true,
          'space_after_semicolon' => true,
          'standardize_not_equals' => true,
          'statement_indentation' => ['stick_comment_to_next_continuous_control_statement' => true],
          'ternary_to_null_coalescing' => true,
          'trailing_comma_in_multiline' => true,
          'trim_array_spaces' => true,
          'type_declaration_spaces' => true,
          'unary_operator_spaces' => true,
          'whitespace_after_comma_in_array' => true,
      ])
      ->setIndent("    ")
      ->setLineEnding("\n");
  
  

• Guarde el archivo y cierre la pestaña.

Posible problema en PHP CS Fixer

Desde la versión 0.3.14 de la extensión PHP CS Fixer, si el nombre de usuario de Windows 10 contiene un espacio en blanco, PHP CS Fixer no funciona. Hasta que el problema sea corregido, una posible solución es utilizar la versión 0.3.13 de la extensión PHP CS Fixer, que no presenta ese problema

• Para modificar la versión de la extensión PHP CS Fixer, abra la ventana de extensiones haciendo clic en el icono correspondiente.

  

• Haga clic derecho en la ficha de la extensión PHP CS Fixer y elija la opción Instalar opción específica.

  

• Se desplegará una lista de versiones disponibles. Haga clic en la opción 0.3.13.

  

• Una vez instalada la versión, haga clic en el botón "Reiniciar extensiones" de la ficha de la extensión PHP CS Fixer.

  

• Una vez reiniciadas las extensiones, el icono de las extensiones mostrará un distintivo que indica que hay actualizaciones disponibles, pero en este caso NO se debe hacer clic en el botón "Actualizar" de la ficha de la extensión PHP CS Fixer.